pakstr 0.5.0 → 0.7.0

package/android-template/app/src/debug/AndroidManifest.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application>
+        <activity-alias
+            android:name=".debug.DeveloperToolsDebugLauncher"
+            android:enabled="true"
+            android:exported="true"
+            android:label="@string/developer_tools_title"
+            android:targetActivity=".debug.DeveloperToolsActivity" />
+    </application>
+</manifest>

package/android-template/app/src/main/AndroidManifest.xml

@@ -28,6 +28,12 @@
         android:supportsRtl="true"
         android:usesCleartextTraffic="true">
 
+        <activity
+            android:name=".debug.DeveloperToolsActivity"
+            android:exported="false"
+            android:label="@string/developer_tools_title"
+            android:theme="@style/Theme.NostrAppShell" />
+
         <activity
             android:name=".MainActivity"
             android:exported="true"

package/android-template/app/src/main/java/com/pakstr/app/MainActivity.kt

@@ -3,11 +3,14 @@ package com.pakstr.app
 import android.Manifest
 import android.content.Intent
 import android.os.Bundle
+import android.os.Handler
+import android.os.Looper
 
 import android.view.View
 import android.webkit.PermissionRequest
 import android.webkit.WebView
 import android.widget.FrameLayout
+import android.widget.Toast
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.enableEdgeToEdge
 import androidx.activity.result.ActivityResultLauncher
@@ -17,11 +20,16 @@ import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
 import androidx.core.view.ViewCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.updatePadding
+import com.google.android.material.floatingactionbutton.FloatingActionButton
 import com.pakstr.app.debug.AppDebugLogger
 import com.pakstr.app.debug.CrashHandler
 
 import com.pakstr.app.debug.DebugReportShare
+import com.pakstr.app.debug.DeveloperToolsAccessManager
+import com.pakstr.app.debug.DeveloperToolsActivity
 import com.pakstr.app.debug.DeveloperToolsManager
+import com.pakstr.app.debug.SupportUnlock
+import com.pakstr.app.debug.SupportUnlockGestureLayout
 import com.pakstr.app.debug.WebViewDebugManager
 
 import com.pakstr.app.permissions.PermissionManager
@@ -43,6 +51,14 @@ class MainActivity : AppCompatActivity(), PermissionHandler {
     private lateinit var amberLauncher:
             ActivityResultLauncher<Intent>
 
+    private lateinit var fab: FloatingActionButton
+    private lateinit var supportUnlockGestureLayout: SupportUnlockGestureLayout
+
+    private val diagnosticsHandler = Handler(Looper.getMainLooper())
+    private val diagnosticsExpiryCheck = Runnable {
+        showDebugFab()
+    }
+
     override fun onCreate(
 
         savedInstanceState: Bundle?
@@ -88,6 +104,8 @@ class MainActivity : AppCompatActivity(), PermissionHandler {
         )
 
         initViews()
+        setupSupportUnlockGesture()
+        showDebugFab()
 
         amberLauncher =
 
@@ -145,6 +163,62 @@ class MainActivity : AppCompatActivity(), PermissionHandler {
 
     }
 
+    private fun showDebugFab() {
+        diagnosticsHandler.removeCallbacks(diagnosticsExpiryCheck)
+
+        if (DeveloperToolsAccessManager.canOpenDeveloperTools(this)) {
+
+            fab.visibility = View.VISIBLE
+
+            fab.setOnClickListener {
+                if (DeveloperToolsAccessManager.canOpenDeveloperTools(this)) {
+                    startActivity(
+
+                        Intent(
+
+                            this,
+
+                            DeveloperToolsActivity::class.java
+
+                        )
+
+                    )
+                } else {
+                    showDebugFab()
+                }
+            }
+
+            val remainingDuration = SupportUnlock.remainingDuration(this)
+            if (!BuildConfig.DEBUG &&
+                !RuntimeConfig.debugEnabled(this) &&
+                remainingDuration > 0L
+            ) {
+                diagnosticsHandler.postDelayed(
+                    diagnosticsExpiryCheck,
+                    remainingDuration
+                )
+            }
+
+        } else {
+
+            fab.visibility = View.GONE
+            fab.setOnClickListener(null)
+
+        }
+    }
+
+    private fun setupSupportUnlockGesture() {
+        supportUnlockGestureLayout.onUnlock = {
+            SupportUnlock.unlock(this)
+            Toast.makeText(
+                this,
+                R.string.diagnostics_mode_enabled,
+                Toast.LENGTH_LONG
+            ).show()
+            showDebugFab()
+        }
+    }
+
     private fun setupBackNavigation() {
         onBackPressedDispatcher.addCallback(
             this,
@@ -187,6 +261,9 @@ class MainActivity : AppCompatActivity(), PermissionHandler {
         container =
             findViewById(R.id.mainContainer)
 
+        supportUnlockGestureLayout =
+            container as SupportUnlockGestureLayout
+
         webView =
             findViewById(R.id.webView)
 
@@ -197,6 +274,10 @@ class MainActivity : AppCompatActivity(), PermissionHandler {
         permissionManager =
             PermissionManager(this)
 
+        fab = findViewById(
+
+            R.id.developerToolsFab)
+
     }
 
     private fun handleSignerSetup() {
@@ -206,7 +287,29 @@ class MainActivity : AppCompatActivity(), PermissionHandler {
         )
     }
 
+    override fun onResume() {
+        super.onResume()
+
+        if (::fab.isInitialized) {
+            showDebugFab()
+        }
+    }
+
+    override fun onStop() {
+        if (::supportUnlockGestureLayout.isInitialized) {
+            supportUnlockGestureLayout.cancelHold()
+        }
+
+        super.onStop()
+    }
+
     override fun onDestroy() {
+        diagnosticsHandler.removeCallbacks(diagnosticsExpiryCheck)
+
+        if (::supportUnlockGestureLayout.isInitialized) {
+            supportUnlockGestureLayout.cancelHold()
+            supportUnlockGestureLayout.onUnlock = null
+        }
 
         if (::runtime.isInitialized) {
 

package/android-template/app/src/main/java/com/pakstr/app/debug/DeveloperToolsAccessManager.kt

@@ -0,0 +1,14 @@
+package com.pakstr.app.debug
+
+import android.content.Context
+import com.pakstr.app.BuildConfig
+import com.pakstr.app.RuntimeConfig
+
+object DeveloperToolsAccessManager {
+
+    fun canOpenDeveloperTools(context: Context): Boolean {
+        return BuildConfig.DEBUG ||
+                RuntimeConfig.debugEnabled(context) ||
+                SupportUnlock.isActive(context)
+    }
+}

package/android-template/app/src/main/java/com/pakstr/app/debug/DeveloperToolsActivity.kt

@@ -0,0 +1,234 @@
+package com.pakstr.app.debug
+
+import android.content.ActivityNotFoundException
+import android.content.Intent
+import android.graphics.Typeface
+import android.net.Uri
+import android.os.Build
+import android.os.Bundle
+import android.os.Handler
+import android.os.Looper
+import android.text.format.DateUtils
+import android.view.ViewGroup
+import android.widget.ScrollView
+import android.widget.TextView
+import android.widget.Toast
+import androidx.activity.enableEdgeToEdge
+import androidx.appcompat.app.AppCompatActivity
+import com.google.android.material.appbar.MaterialToolbar
+import com.google.android.material.button.MaterialButton
+import com.google.android.material.dialog.MaterialAlertDialogBuilder
+import com.google.android.material.switchmaterial.SwitchMaterial
+import com.pakstr.app.BuildConfig
+import com.pakstr.app.R
+import com.pakstr.app.RuntimeConfig
+
+class DeveloperToolsActivity : AppCompatActivity() {
+
+    private val uptimeHandler = Handler(Looper.getMainLooper())
+
+    private lateinit var uptimeValue: TextView
+    private lateinit var debugModeSwitch: SwitchMaterial
+    private lateinit var apiSwitch: SwitchMaterial
+    private lateinit var debugWebViewStatus: TextView
+    private lateinit var webViewStatus: TextView
+
+    private val uptimeUpdater = object : Runnable {
+        override fun run() {
+            uptimeValue.text = DateUtils.formatElapsedTime(DebugSession.uptime() / 1000)
+            uptimeHandler.postDelayed(this, UPTIME_REFRESH_INTERVAL_MS)
+        }
+    }
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_developer_tools)
+
+        setupToolbar()
+        bindViews()
+        populateRuntimeDetails()
+        setupDebugControls()
+        setupLogActions()
+        setupCrashTesting()
+        setupWebViewActions()
+    }
+
+    override fun onStart() {
+        super.onStart()
+        refreshStatuses()
+        uptimeHandler.post(uptimeUpdater)
+    }
+
+    override fun onStop() {
+        uptimeHandler.removeCallbacks(uptimeUpdater)
+        super.onStop()
+    }
+
+    private fun setupToolbar() {
+        findViewById<MaterialToolbar>(R.id.developerToolsToolbar).setNavigationOnClickListener {
+            finish()
+        }
+    }
+
+    private fun bindViews() {
+        uptimeValue = findViewById(R.id.runtimeUptimeValue)
+        debugModeSwitch = findViewById(R.id.debugModeSwitch)
+        apiSwitch = findViewById(R.id.apiEnabledSwitch)
+        debugWebViewStatus = findViewById(R.id.debugWebViewStatus)
+        webViewStatus = findViewById(R.id.webViewStatus)
+    }
+
+    private fun populateRuntimeDetails() {
+        findViewById<TextView>(R.id.runtimeSessionIdValue).text = DebugSession.sessionId
+        findViewById<TextView>(R.id.runtimeAppVersionValue).text = getString(
+            R.string.developer_tools_version_value,
+            BuildConfig.VERSION_NAME,
+            BuildConfig.VERSION_CODE
+        )
+        findViewById<TextView>(R.id.runtimeAndroidVersionValue).text = Build.VERSION.RELEASE
+        findViewById<TextView>(R.id.runtimeDeviceModelValue).text = getString(
+            R.string.developer_tools_device_value,
+            Build.MANUFACTURER,
+            Build.MODEL
+        )
+    }
+
+    private fun setupDebugControls() {
+        apiSwitch.isChecked = RuntimeConfig.apiEnabled(this)
+
+        debugModeSwitch.setOnCheckedChangeListener { _, isChecked ->
+            if (isChecked) {
+                DeveloperToolsManager.enableDebug(this)
+            } else {
+                DeveloperToolsManager.disableDebug(this)
+            }
+
+            WebViewDebugManager.enable(this)
+            refreshStatuses()
+        }
+    }
+
+    private fun refreshStatuses() {
+        debugModeSwitch.isChecked = DeveloperToolsManager.isEnabled(this)
+        apiSwitch.isChecked = RuntimeConfig.apiEnabled(this)
+
+        val status = if (isWebViewDebugEnabled()) {
+            R.string.developer_tools_enabled
+        } else {
+            R.string.developer_tools_disabled
+        }
+        debugWebViewStatus.setText(status)
+        webViewStatus.setText(status)
+    }
+
+    private fun isWebViewDebugEnabled(): Boolean {
+        return BuildConfig.DEBUG || RuntimeConfig.debugEnabled(this)
+    }
+
+    private fun setupLogActions() {
+        findViewById<MaterialButton>(R.id.viewLogsButton).setOnClickListener {
+            showLogs()
+        }
+        findViewById<MaterialButton>(R.id.clearLogsButton).setOnClickListener {
+            confirmClearLogs()
+        }
+        findViewById<MaterialButton>(R.id.exportDebugReportButton).setOnClickListener {
+            exportDebugReport()
+        }
+        findViewById<MaterialButton>(R.id.shareReportButton).setOnClickListener {
+            DebugReportShare.share(this)
+        }
+    }
+
+    private fun showLogs() {
+        val logs = DebugLogStorage.read(this)
+        val content = if (logs.isEmpty()) {
+            getString(R.string.developer_tools_no_logs)
+        } else {
+            logs.joinToString("\n")
+        }
+
+        val textView = TextView(this).apply {
+            text = content
+            typeface = Typeface.MONOSPACE
+            setTextIsSelectable(true)
+            val padding = resources.getDimensionPixelSize(
+                R.dimen.developer_tools_dialog_padding
+            )
+            setPadding(padding, padding, padding, padding)
+        }
+
+        val scrollView = ScrollView(this).apply {
+            addView(textView)
+        }
+
+        MaterialAlertDialogBuilder(this)
+            .setTitle(R.string.developer_tools_view_logs)
+            .setView(scrollView)
+            .setPositiveButton(android.R.string.ok, null)
+            .show()
+            .window
+            ?.setLayout(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)
+    }
+
+    private fun confirmClearLogs() {
+        MaterialAlertDialogBuilder(this)
+            .setTitle(R.string.developer_tools_clear_logs)
+            .setMessage(R.string.developer_tools_clear_logs_confirmation)
+            .setNegativeButton(android.R.string.cancel, null)
+            .setPositiveButton(R.string.developer_tools_clear) { _, _ ->
+                AppDebugLogger.clear(this)
+                showMessage(R.string.developer_tools_logs_cleared)
+            }
+            .show()
+    }
+
+    private fun exportDebugReport() {
+        runCatching {
+            DebugReportExporter.export(this)
+        }.onSuccess { report ->
+            Toast.makeText(
+                this,
+                getString(R.string.developer_tools_report_exported, report.absolutePath),
+                Toast.LENGTH_LONG
+            ).show()
+        }.onFailure {
+            showMessage(R.string.developer_tools_report_export_failed)
+        }
+    }
+
+    private fun setupCrashTesting() {
+        findViewById<MaterialButton>(R.id.throwTestExceptionButton).setOnClickListener {
+            MaterialAlertDialogBuilder(this)
+                .setTitle(R.string.developer_tools_crash_confirmation_title)
+                .setMessage(R.string.developer_tools_crash_confirmation_message)
+                .setNegativeButton(android.R.string.cancel, null)
+                .setPositiveButton(R.string.developer_tools_crash) { _, _ ->
+                    throw RuntimeException(TEST_EXCEPTION_MESSAGE)
+                }
+                .show()
+        }
+    }
+
+    private fun setupWebViewActions() {
+        findViewById<MaterialButton>(R.id.openChromeInspectDocsButton).setOnClickListener {
+            try {
+                startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(CHROME_INSPECT_DOCS_URL)))
+            } catch (_: ActivityNotFoundException) {
+                showMessage(R.string.developer_tools_browser_unavailable)
+            }
+        }
+    }
+
+    private fun showMessage(message: Int) {
+        Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
+    }
+
+    private companion object {
+        const val UPTIME_REFRESH_INTERVAL_MS = 1000L
+        const val TEST_EXCEPTION_MESSAGE = "Developer Tools test exception"
+        const val CHROME_INSPECT_DOCS_URL =
+            "https://developer.chrome.com/docs/devtools/remote-debugging/webviews/"
+    }
+}

package/android-template/app/src/main/java/com/pakstr/app/debug/SupportUnlock.kt

@@ -0,0 +1,44 @@
+package com.pakstr.app.debug
+
+import android.content.Context
+
+object SupportUnlock {
+
+    const val UNLOCK_DURATION_MS = 60 * 60 * 1000L
+
+    private const val PREFERENCES_NAME = "pakstr_support_unlock"
+    private const val EXPIRES_AT_KEY = "expires_at"
+
+    fun unlock(context: Context) {
+        preferences(context)
+            .edit()
+            .putLong(EXPIRES_AT_KEY, System.currentTimeMillis() + UNLOCK_DURATION_MS)
+            .apply()
+    }
+
+    fun isActive(context: Context): Boolean {
+        val remainingDuration = remainingDuration(context)
+
+        if (remainingDuration <= 0L) {
+            clear(context)
+            return false
+        }
+
+        return true
+    }
+
+    fun clear(context: Context) {
+        preferences(context)
+            .edit()
+            .remove(EXPIRES_AT_KEY)
+            .apply()
+    }
+
+    fun remainingDuration(context: Context): Long {
+        val expiresAt = preferences(context).getLong(EXPIRES_AT_KEY, 0L)
+        return (expiresAt - System.currentTimeMillis()).coerceAtLeast(0L)
+    }
+
+    private fun preferences(context: Context) =
+        context.getSharedPreferences(PREFERENCES_NAME, Context.MODE_PRIVATE)
+}

package/android-template/app/src/main/java/com/pakstr/app/debug/SupportUnlockGestureLayout.kt

@@ -0,0 +1,87 @@
+package com.pakstr.app.debug
+
+import android.content.Context
+import android.os.Handler
+import android.os.Looper
+import android.util.AttributeSet
+import android.view.MotionEvent
+import android.view.ViewConfiguration
+import android.widget.FrameLayout
+import kotlin.math.abs
+
+class SupportUnlockGestureLayout @JvmOverloads constructor(
+    context: Context,
+    attrs: AttributeSet? = null,
+    defStyleAttr: Int = 0
+) : FrameLayout(context, attrs, defStyleAttr) {
+
+    var onUnlock: (() -> Unit)? = null
+
+    private val handler = Handler(Looper.getMainLooper())
+    private val touchSlop = ViewConfiguration.get(context).scaledTouchSlop
+    private val cornerSize = CORNER_SIZE_DP * resources.displayMetrics.density
+
+    private var tracking = false
+    private var downX = 0f
+    private var downY = 0f
+
+    private val unlockRunnable = Runnable {
+        if (tracking) {
+            tracking = false
+            onUnlock?.invoke()
+        }
+    }
+
+    override fun dispatchTouchEvent(event: MotionEvent): Boolean {
+        observeTouch(event)
+        return super.dispatchTouchEvent(event)
+    }
+
+    fun cancelHold() {
+        tracking = false
+        handler.removeCallbacks(unlockRunnable)
+    }
+
+    override fun onDetachedFromWindow() {
+        cancelHold()
+        super.onDetachedFromWindow()
+    }
+
+    private fun observeTouch(event: MotionEvent) {
+        when (event.actionMasked) {
+            MotionEvent.ACTION_DOWN -> {
+                if (isInTopRightCorner(event.x, event.y)) {
+                    tracking = true
+                    downX = event.x
+                    downY = event.y
+                    handler.postDelayed(unlockRunnable, HOLD_DURATION_MS)
+                } else {
+                    cancelHold()
+                }
+            }
+
+            MotionEvent.ACTION_MOVE -> {
+                if (tracking && hasMovedBeyondTouchSlop(event.x, event.y)) {
+                    cancelHold()
+                }
+            }
+
+            MotionEvent.ACTION_POINTER_DOWN,
+            MotionEvent.ACTION_UP,
+            MotionEvent.ACTION_CANCEL -> cancelHold()
+        }
+    }
+
+    private fun isInTopRightCorner(x: Float, y: Float): Boolean {
+        return x >= width - cornerSize && y <= paddingTop + cornerSize
+    }
+
+    private fun hasMovedBeyondTouchSlop(x: Float, y: Float): Boolean {
+        return abs(x - downX) > touchSlop || abs(y - downY) > touchSlop
+    }
+
+    private companion object {
+        const val HOLD_DURATION_MS = 10_000L
+        const val CORNER_SIZE_DP = 72
+    }
+}

package/android-template/app/src/main/res/layout/activity_developer_tools.xml

@@ -0,0 +1,308 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:paddingBottom="56dp"
+    android:background="?android:attr/colorBackground"
+    android:orientation="vertical">
+
+    <com.google.android.material.appbar.MaterialToolbar
+        android:id="@+id/developerToolsToolbar"
+        android:layout_width="match_parent"
+        android:layout_height="?attr/actionBarSize"
+        android:background="?attr/colorSurface"
+        android:elevation="4dp"
+        app:navigationIcon="?attr/homeAsUpIndicator"
+        app:title="@string/developer_tools_title" />
+
+    <androidx.core.widget.NestedScrollView
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1"
+        android:fillViewport="true">
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            android:padding="16dp">
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginBottom="16dp"
+                app:cardCornerRadius="12dp"
+                app:cardElevation="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="16dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="16dp"
+                        android:text="@string/developer_tools_runtime" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_session_id" />
+
+                    <TextView
+                        android:id="@+id/runtimeSessionIdValue"
+                        style="@style/TextAppearance.MaterialComponents.Body2"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="12dp"
+                        android:textIsSelectable="true" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_app_version" />
+
+                    <TextView
+                        android:id="@+id/runtimeAppVersionValue"
+                        style="@style/TextAppearance.MaterialComponents.Body2"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="12dp" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_android_version" />
+
+                    <TextView
+                        android:id="@+id/runtimeAndroidVersionValue"
+                        style="@style/TextAppearance.MaterialComponents.Body2"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="12dp" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_device_model" />
+
+                    <TextView
+                        android:id="@+id/runtimeDeviceModelValue"
+                        style="@style/TextAppearance.MaterialComponents.Body2"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="12dp" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_app_uptime" />
+
+                    <TextView
+                        android:id="@+id/runtimeUptimeValue"
+                        style="@style/TextAppearance.MaterialComponents.Body2"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content" />
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginBottom="16dp"
+                app:cardCornerRadius="12dp"
+                app:cardElevation="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="16dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="8dp"
+                        android:text="@string/developer_tools_debug" />
+
+                    <com.google.android.material.switchmaterial.SwitchMaterial
+                        android:id="@+id/debugModeSwitch"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_enable_debug_mode" />
+
+                    <com.google.android.material.switchmaterial.SwitchMaterial
+                        android:id="@+id/apiEnabledSwitch"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:enabled="false"
+                        android:text="@string/developer_tools_enable_api" />
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Caption"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginStart="4dp"
+                        android:layout_marginBottom="16dp"
+                        android:text="@string/developer_tools_api_read_only" />
+
+                    <LinearLayout
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:gravity="center_vertical"
+                        android:orientation="horizontal">
+
+                        <TextView
+                            style="@style/TextAppearance.MaterialComponents.Body1"
+                            android:layout_width="0dp"
+                            android:layout_height="wrap_content"
+                            android:layout_weight="1"
+                            android:text="@string/developer_tools_webview_debug" />
+
+                        <TextView
+                            android:id="@+id/debugWebViewStatus"
+                            style="@style/TextAppearance.MaterialComponents.Body2"
+                            android:layout_width="wrap_content"
+                            android:layout_height="wrap_content" />
+                    </LinearLayout>
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginBottom="16dp"
+                app:cardCornerRadius="12dp"
+                app:cardElevation="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="16dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="8dp"
+                        android:text="@string/developer_tools_logs" />
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/viewLogsButton"
+                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_view_logs" />
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/clearLogsButton"
+                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_clear_logs" />
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/exportDebugReportButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_export_debug_report" />
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/shareReportButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_share_report" />
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginBottom="16dp"
+                app:cardCornerRadius="12dp"
+                app:cardElevation="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="16dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="8dp"
+                        android:text="@string/developer_tools_crash_testing" />
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/throwTestExceptionButton"
+                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_throw_test_exception" />
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
+
+            <com.google.android.material.card.MaterialCardView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                app:cardCornerRadius="12dp"
+                app:cardElevation="1dp">
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical"
+                    android:padding="16dp">
+
+                    <TextView
+                        style="@style/TextAppearance.MaterialComponents.Headline6"
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="12dp"
+                        android:text="@string/developer_tools_webview" />
+
+                    <LinearLayout
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="12dp"
+                        android:gravity="center_vertical"
+                        android:orientation="horizontal">
+
+                        <TextView
+                            style="@style/TextAppearance.MaterialComponents.Body1"
+                            android:layout_width="0dp"
+                            android:layout_height="wrap_content"
+                            android:layout_weight="1"
+                            android:text="@string/developer_tools_current_status" />
+
+                        <TextView
+                            android:id="@+id/webViewStatus"
+                            style="@style/TextAppearance.MaterialComponents.Body2"
+                            android:layout_width="wrap_content"
+                            android:layout_height="wrap_content" />
+                    </LinearLayout>
+
+                    <com.google.android.material.button.MaterialButton
+                        android:id="@+id/openChromeInspectDocsButton"
+                        style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:text="@string/developer_tools_open_chrome_inspect_docs" />
+                </LinearLayout>
+            </com.google.android.material.card.MaterialCardView>
+        </LinearLayout>
+    </androidx.core.widget.NestedScrollView>
+</LinearLayout>

package/android-template/app/src/main/res/layout/activity_layout.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+<com.pakstr.app.debug.SupportUnlockGestureLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/mainContainer"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
@@ -18,4 +18,13 @@
         android:layout_gravity="center"
         android:indeterminateDrawable="@drawable/custom_loader" />
 
-</FrameLayout>
+    <com.google.android.material.floatingactionbutton.FloatingActionButton
+        android:id="@+id/developerToolsFab"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_gravity="bottom|end"
+        android:layout_margin="24dp"
+        android:contentDescription="@string/developer_tools"
+        android:src="@android:drawable/ic_menu_info_details" />
+
+</com.pakstr.app.debug.SupportUnlockGestureLayout>

package/android-template/app/src/main/res/values/dimes.xml

@@ -3,4 +3,5 @@
 
     <dimen name="loader_height">50dp</dimen>
     <dimen name="loader_width">50dp</dimen>
+    <dimen name="developer_tools_dialog_padding">24dp</dimen>
 </resources>

package/android-template/app/src/main/res/values/strings.xml

@@ -1,3 +1,47 @@
 <resources>
     <string name="app_name">Pakstr</string>
+
+    <string name="developer_tools_title">Developer Tools</string>
+    <string name="developer_tools_runtime">Runtime</string>
+    <string name="developer_tools_session_id">Session ID</string>
+    <string name="developer_tools_app_version">App version</string>
+    <string name="developer_tools_android_version">Android version</string>
+    <string name="developer_tools_device_model">Device model</string>
+    <string name="developer_tools_app_uptime">App uptime</string>
+    <string name="developer_tools_version_value">%1$s (%2$d)</string>
+    <string name="developer_tools_device_value">%1$s %2$s</string>
+
+    <string name="developer_tools_debug">Debug</string>
+    <string name="developer_tools_enable_debug_mode">Enable Debug Mode</string>
+    <string name="developer_tools_enable_api">Enable API</string>
+    <string name="developer_tools_api_read_only">Controlled by the packaged runtime configuration.</string>
+    <string name="developer_tools_webview_debug">WebView Debug</string>
+    <string name="developer_tools_enabled">Enabled</string>
+    <string name="developer_tools_disabled">Disabled</string>
+
+    <string name="developer_tools_logs">Logs</string>
+    <string name="developer_tools_view_logs">View Logs</string>
+    <string name="developer_tools_clear_logs">Clear Logs</string>
+    <string name="developer_tools_export_debug_report">Export Debug Report</string>
+    <string name="developer_tools_share_report">Share Report</string>
+    <string name="developer_tools_no_logs">No logs recorded.</string>
+    <string name="developer_tools_clear_logs_confirmation">Clear all stored debug logs?</string>
+    <string name="developer_tools_clear">Clear</string>
+    <string name="developer_tools_logs_cleared">Logs cleared.</string>
+    <string name="developer_tools_report_exported">Report exported to %1$s</string>
+    <string name="developer_tools_report_export_failed">Unable to export the debug report.</string>
+
+    <string name="developer_tools_crash_testing">Crash Testing</string>
+    <string name="developer_tools_throw_test_exception">Throw Test Exception</string>
+    <string name="developer_tools_crash_confirmation_title">Crash Pakstr?</string>
+    <string name="developer_tools_crash_confirmation_message">This intentionally throws an uncaught RuntimeException and closes the app so CrashHandler can capture it.</string>
+    <string name="developer_tools_crash">Crash</string>
+
+    <string name="developer_tools_webview">WebView</string>
+    <string name="developer_tools_current_status">Current WebView Debug status</string>
+    <string name="developer_tools_open_chrome_inspect_docs">Open Chrome Inspect documentation</string>
+    <string name="developer_tools_browser_unavailable">No browser is available.</string>
+
+    <string name="developer_tools">Open Developer Tools</string>
+    <string name="diagnostics_mode_enabled">Diagnostics mode enabled</string>
 </resources>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pakstr",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "CLI for packaging Nostr web apps into Android APKs",
   "type": "commonjs",
   "main": "dist/index.js",