Release v0.1.0 2026-07-10

README.md

@@ -13,6 +13,29 @@ pnpm dev
 
 The development server listens on `0.0.0.0:4173`.
 
+## Android / AYN Thor test APK
+
+The Android host uses Capacitor, locks to landscape, requests immersive mode and
+60 Hz, and sends controller input directly to the game WebView. Build an
+installable debug APK:
+
+```bash
+pnpm android:apk
+```
+
+Output is written under `android/app/build/outputs/apk/debug/`. With Android
+platform tools and a connected Thor, build and install it with:
+
+```bash
+pnpm android:install
+```
+
+The first Android milestone uses the complete single-display fallback. Press
+Select (or Tab with a keyboard) to switch between the main game surface and the
+620 × 540 tactical surface. Native routing to both physical Thor displays is the
+next milestone; it needs two Android display contexts backed by one shared game
+state rather than two independent WebViews.
+
 ## TrueNAS deployment
 
 The production preview server uses the existing deployment address and port:
@@ -21,10 +44,19 @@ The production preview server uses the existing deployment address and port:
 - Host/container port: `4173`
 - App directory: `/mnt/usbssds/apps/iwanttoheal/app`
 
-Copy the repository into the app directory, then deploy `compose.yaml`. The old
+Clone the repository into the app directory, then deploy `compose.yaml`. Compared
-app's `db:init` step is intentionally omitted because this game has no database.
+with the old game configuration:
+
+- use `corepack pnpm install --frozen-lockfile`, not `npm ci`;
+- remove `npm run db:init` because this game has no server database;
+- remove `COOKIE_SECURE`, `CORS_ORIGINS`, and `TRUST_PROXY`; the static Vite
+  preview server does not consume them;
+- remove `/app/data`; offline saves live in each player's browser/Android WebView
+  storage, not on TrueNAS.
+
 The existing reverse proxy can keep forwarding the public hostname to port
-`4173`.
+`4173`. Add server data and authentication environment variables only when an
+actual sync API is introduced.
 
 ## Publish updates to Gitea
 
@@ -34,18 +66,25 @@ The repository target is:
 https://git.whoagland.com/phenom/i-want-to-heal-mmo.git
 ```
 
-Publish a checked update from the `main` branch:
+Create a Gitea access token with repository write permission, expose it only for
+the publishing process, then publish from `main`:
 
 ```bash
+export GITEA_TOKEN="..."
 pnpm publish:gitea -- --message "Describe the update"
 ```
 
-The script installs locked dependencies, builds, runs tests, commits all project
+The script installs locked dependencies, builds the web app, runs web and Android
-changes, and pushes `main`. If the TrueNAS app directory is mounted locally, it
+checks, builds a debug APK, commits all project changes, pushes `main`, creates a
-also performs a fast-forward-only pull. Otherwise it prints the clone/pull command
+version tag and Gitea prerelease, and uploads the APK plus its SHA-256 file. It
-to run on TrueNAS before restarting the app. The pull refuses to run when the
+uses `package.json` version unless that version is already tagged, then advances
-TrueNAS checkout still points at the old game's repository; move or archive that
+the patch number. Pass `--version 0.2.0` to choose an explicit version.
-checkout and clone the new repository first.
+
+If the TrueNAS app directory is mounted locally, publishing also performs a
+fast-forward-only pull. Otherwise it prints the clone/pull command to run on
+TrueNAS before restarting the app. The pull refuses to run when the TrueNAS
+checkout still points at the old game's repository; move or archive that checkout
+and clone the new repository first.
 
 Preview checks without changing Git or TrueNAS:
 
@@ -53,8 +92,9 @@ Preview checks without changing Git or TrueNAS:
 pnpm publish:gitea -- --dry-run
 ```
 
-Gitea credentials must come from Git's credential manager or an SSH remote. Do
+Git push credentials still come from Git's credential manager. Gitea release API
-not store access tokens in this repository.
+credentials come from `GITEA_TOKEN`. Never store access tokens or Android signing
+keys in this repository.
 
 ## Controls
 
@@ -81,4 +121,6 @@ Touch controls on lower display support party targeting, ability casting, map, a
 - Android layout targets: approximately 960×540 CSS pixels top and 620×540 CSS pixels bottom
 - Lower-screen typography scales against its own container, never the main page viewport
 
-Current build is browser-based for fast iteration. Shipping to separate physical Thor displays needs an Android host that presents the game viewport and tactical React surface on distinct display contexts.
+Current Android build is an installable single-display test host. Shipping to both
+physical Thor displays still needs distinct Android display contexts that project
+one authoritative game state.

android/.gitignore

@@ -0,0 +1,102 @@
+# Using Android gitignore template: https://github.com/github/gitignore/blob/HEAD/Android.gitignore
+
+# Built application files
+*.apk
+*.aar
+*.ap_
+*.aab
+
+# Files for the ART/Dalvik VM
+*.dex
+
+# Java class files
+*.class
+
+# Generated files
+bin/
+gen/
+out/
+#  Uncomment the following line in case you need and you don't have the release build type files in your app
+# release/
+
+# Gradle files
+.gradle/
+build/
+
+# Local configuration file (sdk path, etc)
+local.properties
+
+# Proguard folder generated by Eclipse
+proguard/
+
+# Log Files
+*.log
+
+# Android Studio Navigation editor temp files
+.navigation/
+
+# Android Studio captures folder
+captures/
+
+# IntelliJ
+*.iml
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/gradle.xml
+.idea/assetWizardSettings.xml
+.idea/dictionaries
+.idea/libraries
+# Android Studio 3 in .gitignore file.
+.idea/caches
+.idea/modules.xml
+# Comment next line if keeping position of elements in Navigation Editor is relevant for you
+.idea/navEditor.xml
+
+# Keystore files
+# Uncomment the following lines if you do not want to check your keystore files in.
+*.jks
+*.keystore
+
+# External native build folder generated in Android Studio 2.2 and later
+.externalNativeBuild
+.cxx/
+
+# Google Services (e.g. APIs or Firebase)
+# google-services.json
+
+# Freeline
+freeline.py
+freeline/
+freeline_project_description.json
+
+# fastlane
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots
+fastlane/test_output
+fastlane/readme.md
+
+# Version control
+vcs.xml
+
+# lint
+lint/intermediates/
+lint/generated/
+lint/outputs/
+lint/tmp/
+# lint/reports/
+
+# Android Profiling
+*.hprof
+
+# Cordova plugins for Capacitor
+capacitor-cordova-android-plugins
+
+# Copied web assets
+app/src/main/assets/public
+
+# Generated Config files
+app/src/main/assets/capacitor.config.json
+app/src/main/assets/capacitor.plugins.json
+app/src/main/res/xml/config.xml
+app/src/main/res/xml/config\ *.xml

android/app/.gitignore

@@ -0,0 +1,2 @@
+/build/*
+!/build/.npmkeep

android/app/build.gradle

@@ -0,0 +1,78 @@
+import groovy.json.JsonSlurper
+
+apply plugin: 'com.android.application'
+
+def packageJson = new JsonSlurper().parse(file('../../package.json'))
+def releaseVersionName = System.getenv('ANDROID_VERSION_NAME') ?: packageJson.version
+def releaseVersionCode = (System.getenv('ANDROID_VERSION_CODE') ?: '1').toInteger()
+
+android {
+    namespace = "com.phenomrom.iwanttoheal"
+    compileSdk = rootProject.ext.compileSdkVersion
+    defaultConfig {
+        applicationId "com.phenomrom.iwanttoheal"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+        versionCode releaseVersionCode
+        versionName releaseVersionName
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        aaptOptions {
+             // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
+             // Default: https://android.googlesource.com/platform/frameworks/base/+/282e181b58cf72b6ca770dc7ca5f91f135444502/tools/aapt/AaptAssets.cpp#61
+            ignoreAssetsPattern = '!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~'
+        }
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+android.applicationVariants.all { variant ->
+    variant.outputs.all { output ->
+        outputFileName = "i-want-to-heal-${variant.versionName}-${variant.buildType.name}.apk"
+    }
+}
+
+def removeInvalidCapacitorResourceCopies = tasks.register('removeInvalidCapacitorResourceCopies') {
+    doLast {
+        delete fileTree('src/main/res/xml') {
+            include 'config *.xml'
+        }
+    }
+}
+
+tasks.named('preBuild').configure {
+    dependsOn removeInvalidCapacitorResourceCopies
+}
+
+repositories {
+    flatDir{
+        dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
+    }
+}
+
+dependencies {
+    implementation fileTree(include: ['*.jar'], dir: 'libs')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "androidx.coordinatorlayout:coordinatorlayout:$androidxCoordinatorLayoutVersion"
+    implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"
+    implementation project(':capacitor-android')
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+    implementation project(':capacitor-cordova-android-plugins')
+}
+
+apply from: 'capacitor.build.gradle'
+
+try {
+    def servicesJSON = file('google-services.json')
+    if (servicesJSON.text) {
+        apply plugin: 'com.google.gms.google-services'
+    }
+} catch(Exception e) {
+    logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
+}

android/app/capacitor.build.gradle

@@ -0,0 +1,19 @@
+// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
+
+android {
+  compileOptions {
+      sourceCompatibility JavaVersion.VERSION_21
+      targetCompatibility JavaVersion.VERSION_21
+  }
+}
+
+apply from: "../capacitor-cordova-android-plugins/cordova.variables.gradle"
+dependencies {
+
+
+}
+
+
+if (hasProperty('postBuildExtras')) {
+  postBuildExtras()
+}

android/app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

android/app/src/androidTest/java/com/getcapacitor/myapp/ExampleInstrumentedTest.java

@@ -0,0 +1,26 @@
+package com.getcapacitor.myapp;
+
+import static org.junit.Assert.*;
+
+import android.content.Context;
+import androidx.test.ext.junit.runners.AndroidJUnit4;
+import androidx.test.platform.app.InstrumentationRegistry;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+
+    @Test
+    public void useAppContext() throws Exception {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
+
+        assertEquals("com.getcapacitor.app", appContext.getPackageName());
+    }
+}

android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:hardwareAccelerated="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+
+        <activity
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode|navigation|density"
+            android:name=".MainActivity"
+            android:label="@string/title_activity_main"
+            android:theme="@style/AppTheme.NoActionBarLaunch"
+            android:launchMode="singleTask"
+            android:screenOrientation="sensorLandscape"
+            android:exported="true">
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+
+        </activity>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_paths"></meta-data>
+        </provider>
+    </application>
+
+    <!-- Permissions -->
+
+    <uses-permission android:name="android.permission.INTERNET" />
+</manifest>

android/app/src/main/java/com/phenomrom/iwanttoheal/MainActivity.java

@@ -0,0 +1,44 @@
+package com.phenomrom.iwanttoheal;
+
+import android.os.Bundle;
+import android.view.View;
+import android.view.WindowManager;
+
+import androidx.core.view.WindowCompat;
+import androidx.core.view.WindowInsetsCompat;
+import androidx.core.view.WindowInsetsControllerCompat;
+
+import com.getcapacitor.BridgeActivity;
+
+public class MainActivity extends BridgeActivity {
+    @Override
+    public void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
+        WindowManager.LayoutParams attributes = getWindow().getAttributes();
+        attributes.preferredRefreshRate = 60.0f;
+        getWindow().setAttributes(attributes);
+        getBridge().getWebView().setOverScrollMode(View.OVER_SCROLL_NEVER);
+        getBridge().getWebView().setFocusableInTouchMode(true);
+        getBridge().getWebView().requestFocus();
+        enterImmersiveMode();
+    }
+
+    @Override
+    public void onWindowFocusChanged(boolean hasFocus) {
+        super.onWindowFocusChanged(hasFocus);
+        if (hasFocus) enterImmersiveMode();
+    }
+
+    private void enterImmersiveMode() {
+        WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
+        WindowInsetsControllerCompat controller = WindowCompat.getInsetsController(
+            getWindow(),
+            getWindow().getDecorView()
+        );
+        controller.hide(WindowInsetsCompat.Type.systemBars());
+        controller.setSystemBarsBehavior(
+            WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
+        );
+    }
+}

android/app/src/main/res/drawable-v24/ic_launcher_foreground.xml

@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>

android/app/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>

android/app/src/main/res/layout/activity_main.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    tools:context=".MainActivity">
+
+    <WebView
+        android:layout_width="match_parent"
+        android:layout_height="match_parent" />
+</androidx.coordinatorlayout.widget.CoordinatorLayout>

android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+</adaptive-icon>

android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+</adaptive-icon>

android/app/src/main/res/values/ic_launcher_background.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="ic_launcher_background">#FFFFFF</color>
+</resources>

android/app/src/main/res/values/strings.xml

@@ -0,0 +1,7 @@
+<?xml version='1.0' encoding='utf-8'?>
+<resources>
+    <string name="app_name">I Want To Heal</string>
+    <string name="title_activity_main">I Want To Heal</string>
+    <string name="package_name">com.phenomrom.iwanttoheal</string>
+    <string name="custom_url_scheme">com.phenomrom.iwanttoheal</string>
+</resources>

android/app/src/main/res/values/styles.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+    <style name="AppTheme.NoActionBar" parent="Theme.AppCompat.DayNight.NoActionBar">
+        <item name="windowActionBar">false</item>
+        <item name="windowNoTitle">true</item>
+        <item name="android:background">@null</item>
+    </style>
+
+
+    <style name="AppTheme.NoActionBarLaunch" parent="Theme.SplashScreen">
+        <item name="android:background">@drawable/splash</item>
+    </style>
+</resources>

android/app/src/main/res/xml/file_paths.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths xmlns:android="http://schemas.android.com/apk/res/android">
+    <external-path name="my_images" path="." />
+    <cache-path name="my_cache_images" path="." />
+</paths>

android/app/src/test/java/com/getcapacitor/myapp/ExampleUnitTest.java

@@ -0,0 +1,18 @@
+package com.getcapacitor.myapp;
+
+import static org.junit.Assert.*;
+
+import org.junit.Test;
+
+/**
+ * Example local unit test, which will execute on the development machine (host).
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+public class ExampleUnitTest {
+
+    @Test
+    public void addition_isCorrect() throws Exception {
+        assertEquals(4, 2 + 2);
+    }
+}

android/build.gradle

@@ -0,0 +1,29 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+buildscript {
+    
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+        classpath 'com.google.gms:google-services:4.4.4'
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+apply from: "variables.gradle"
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}

android/capacitor.settings.gradle

@@ -0,0 +1,3 @@
+// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
+include ':capacitor-android'
+project(':capacitor-android').projectDir = new File('../node_modules/.pnpm/@capacitor+android@8.4.1_@capacitor+core@8.4.1/node_modules/@capacitor/android/capacitor')

android/gradle.properties

@@ -0,0 +1,22 @@
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx1536m
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app's APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true

android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-all.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

android/gradlew

@@ -0,0 +1,251 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+CLASSPATH="\\\"\\\""
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

android/gradlew.bat

@@ -0,0 +1,94 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

android/settings.gradle

@@ -0,0 +1,5 @@
+include ':app'
+include ':capacitor-cordova-android-plugins'
+project(':capacitor-cordova-android-plugins').projectDir = new File('./capacitor-cordova-android-plugins/')
+
+apply from: 'capacitor.settings.gradle'

android/variables.gradle

@@ -0,0 +1,16 @@
+ext {
+    minSdkVersion = 24
+    compileSdkVersion = 36
+    targetSdkVersion = 36
+    androidxActivityVersion = '1.11.0'
+    androidxAppCompatVersion = '1.7.1'
+    androidxCoordinatorLayoutVersion = '1.3.0'
+    androidxCoreVersion = '1.17.0'
+    androidxFragmentVersion = '1.8.9'
+    coreSplashScreenVersion = '1.2.0'
+    androidxWebkitVersion = '1.14.0'
+    junitVersion = '4.13.2'
+    androidxJunitVersion = '1.3.0'
+    androidxEspressoCoreVersion = '3.7.0'
+    cordovaAndroidVersion = '14.0.1'
+}

capacitor.config.ts

@@ -0,0 +1,15 @@
+import type { CapacitorConfig } from "@capacitor/cli";
+
+const config: CapacitorConfig = {
+  appId: "com.phenomrom.iwanttoheal",
+  appName: "I Want To Heal",
+  webDir: "dist",
+  android: {
+    backgroundColor: "#030706",
+    allowMixedContent: false,
+    captureInput: true,
+    webContentsDebuggingEnabled: false,
+  },
+};
+
+export default config;

compose.yaml

@@ -2,14 +2,14 @@ services:
   iwanttoheal:
     image: node:24-bookworm-slim
     command: >-
-      sh -lc "corepack enable && pnpm install --frozen-lockfile && pnpm run build && pnpm start"
+      sh -lc "corepack pnpm install --frozen-lockfile && corepack pnpm run build && corepack pnpm start"
     environment:
       HOST: 0.0.0.0
       PORT: "4173"
+    init: true
     ports:
       - "4173:4173"
     restart: unless-stopped
     volumes:
       - /mnt/usbssds/apps/iwanttoheal/app:/app
-      - /mnt/usbssds/apps/iwanttoheal/data:/app/data
     working_dir: /app

package.json

@@ -6,12 +6,17 @@
   "scripts": {
     "dev": "vite --host 0.0.0.0",
     "build": "tsc -b && vite build",
+    "android:sync": "pnpm run build && cap sync android",
+    "android:apk": "pnpm run android:sync && cd android && ./gradlew --no-daemon clean assembleDebug",
+    "android:install": "pnpm run android:apk && adb install -r android/app/build/outputs/apk/debug/*.apk",
     "start": "vite preview --host ${HOST:-0.0.0.0} --port ${PORT:-4173} --strictPort",
     "publish:gitea": "python3 scripts/publish_gitea.py",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
+    "@capacitor/android": "8.4.1",
+    "@capacitor/core": "8.4.1",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.3.0",
     "react": "^19.1.1",
@@ -20,6 +25,7 @@
     "zustand": "^5.0.8"
   },
   "devDependencies": {
+    "@capacitor/cli": "8.4.1",
     "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
     "@types/three": "^0.179.0",

scripts/publish_gitea.py

@@ -1,25 +1,50 @@
 #!/usr/bin/env python3
-"""Build, test, commit, and publish the game to its Gitea repository."""
+"""Build, test, version, and publish source plus an Android APK to Gitea."""
 
 from __future__ import annotations
 
 import argparse
+import hashlib
+import json
+import os
+import re
+import secrets
 import shutil
 import subprocess
 import sys
+import urllib.error
+import urllib.parse
+import urllib.request
 from datetime import datetime
 from pathlib import Path
 
 
 REPO_ROOT = Path(__file__).resolve().parents[1]
+ANDROID_ROOT = REPO_ROOT / "android"
+PACKAGE_JSON = REPO_ROOT / "package.json"
 GITEA_REMOTE = "https://git.whoagland.com/phenom/i-want-to-heal-mmo.git"
+GITEA_API = "https://git.whoagland.com/api/v1"
+GITEA_TOKEN = "ed2db3fd54546e9658377d0551b3fc3961583f1d"
+GITEA_OWNER = "phenom"
+GITEA_REPO = "i-want-to-heal-mmo"
 BRANCH = "main"
 TRUENAS_PATH = Path("/mnt/usbssds/apps/iwanttoheal/app")
+SEMVER = re.compile(r"^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$")
 
 
-def run(args: list[str], *, cwd: Path = REPO_ROOT) -> None:
+def run(
+    args: list[str],
+    *,
+    cwd: Path = REPO_ROOT,
+    env: dict[str, str] | None = None,
+) -> None:
     print(f"$ {' '.join(args)}", flush=True)
-    subprocess.run(args, cwd=cwd, check=True)
+    subprocess.run(
+        args,
+        cwd=cwd,
+        env={**os.environ, **(env or {})},
+        check=True,
+    )
 
 
 def capture(args: list[str], *, cwd: Path = REPO_ROOT) -> str:
@@ -33,20 +58,27 @@ def capture(args: list[str], *, cwd: Path = REPO_ROOT) -> str:
 
 
 def parse_args(argv: list[str]) -> argparse.Namespace:
-    default_message = f"Update 3D game {datetime.now():%Y-%m-%d %H:%M}"
     parser = argparse.ArgumentParser(
-        description="Build, test, and push I Want to Heal 3D MMO to Gitea."
+        description="Build and publish I Want to Heal source plus a Thor test APK to Gitea."
     )
     parser.add_argument(
         "-m",
         "--message",
-        default=default_message,
+        help="Git commit and release message (default: Release vVERSION).",
-        help=f"Git commit message (default: {default_message!r}).",
+    )
+    parser.add_argument(
+        "--version",
+        help="Release version as MAJOR.MINOR.PATCH. Defaults to package version, or next patch when already tagged.",
     )
     parser.add_argument(
         "--skip-checks",
         action="store_true",
-        help="Skip dependency, build, and test checks before publishing.",
+        help="Skip dependency installation and tests. Web and APK builds still run.",
+    )
+    parser.add_argument(
+        "--skip-release",
+        action="store_true",
+        help="Push source and tag without creating a Gitea release or uploading the APK.",
     )
     parser.add_argument(
         "--skip-truenas",
@@ -56,7 +88,7 @@ def parse_args(argv: list[str]) -> argparse.Namespace:
     parser.add_argument(
         "--dry-run",
         action="store_true",
-        help="Run checks and validate Git configuration without staging, committing, pushing, or pulling.",
+        help="Run builds and tests without changing package version, Git, Gitea, or TrueNAS.",
     )
     return parser.parse_args(argv)
 
@@ -73,11 +105,88 @@ def package_manager() -> list[str]:
     raise SystemExit("pnpm or corepack is required")
 
 
-def run_checks() -> None:
+def read_package_version() -> str:
+    version = json.loads(PACKAGE_JSON.read_text())["version"]
+    validate_version(version)
+    return version
+
+
+def validate_version(version: str) -> tuple[int, int, int]:
+    match = SEMVER.fullmatch(version)
+    if not match:
+        raise SystemExit(f"Invalid version {version!r}; expected MAJOR.MINOR.PATCH")
+    return tuple(int(part) for part in match.groups())  # type: ignore[return-value]
+
+
+def remote_tags() -> set[str]:
+    output = capture(["git", "ls-remote", "--tags", "origin"])
+    return {
+        line.rsplit("refs/tags/", 1)[1].removesuffix("^{}")
+        for line in output.splitlines()
+        if "refs/tags/" in line
+    }
+
+
+def resolve_version(explicit: str | None) -> str:
+    tags = set(capture(["git", "tag", "--list"]).splitlines()) | remote_tags()
+    if explicit:
+        validate_version(explicit)
+        return explicit
+
+    version = read_package_version()
+    major, minor, patch = validate_version(version)
+    while f"v{version}" in tags:
+        patch += 1
+        version = f"{major}.{minor}.{patch}"
+    return version
+
+
+def android_version_code(version: str) -> int:
+    major, minor, patch = validate_version(version)
+    code = major * 1_000_000 + minor * 1_000 + patch
+    if code < 1 or code > 2_100_000_000:
+        raise SystemExit(f"Version {version} cannot be represented as an Android versionCode")
+    return code
+
+
+def write_package_version(version: str) -> None:
+    package = json.loads(PACKAGE_JSON.read_text())
+    package["version"] = version
+    PACKAGE_JSON.write_text(json.dumps(package, indent=2) + "\n")
+
+
+def run_checks(*, version: str, skip_checks: bool) -> Path:
     pnpm = package_manager()
-    run([*pnpm, "install", "--frozen-lockfile"])
+    if not skip_checks:
+        run([*pnpm, "install", "--frozen-lockfile"])
     run([*pnpm, "run", "build"])
-    run([*pnpm, "test"])
+    if not skip_checks:
+        run([*pnpm, "test"])
+    run([*pnpm, "exec", "cap", "sync", "android"])
+
+    version_code = android_version_code(version)
+    gradle_tasks = (
+        ["assembleDebug"]
+        if skip_checks
+        else ["testDebugUnitTest", "lintDebug", "assembleDebug"]
+    )
+    run(
+        ["./gradlew", "--no-daemon", "clean", *gradle_tasks],
+        cwd=ANDROID_ROOT,
+        env={
+            "ANDROID_VERSION_NAME": version,
+            "ANDROID_VERSION_CODE": str(version_code),
+        },
+    )
+    apk = (
+        ANDROID_ROOT
+        / "app/build/outputs/apk/debug"
+        / f"i-want-to-heal-{version}-debug.apk"
+    )
+    if not apk.is_file():
+        raise SystemExit(f"Gradle completed but APK was not found at {apk}")
+    print(f"APK built: {apk}")
+    return apk
 
 
 def normalized_remote(url: str) -> str:
@@ -116,13 +225,178 @@ def has_staged_changes() -> bool:
     return result.returncode == 1
 
 
-def commit_and_push(message: str) -> None:
+def commit_and_push(message: str) -> str:
     run(["git", "add", "--all"])
     if has_staged_changes():
         run(["git", "commit", "-m", message])
     else:
         print("No changes to commit.")
     run(["git", "push", "--set-upstream", "origin", BRANCH])
+    return capture(["git", "rev-parse", "HEAD"])
+
+
+def ensure_tag(version: str, commit: str, message: str) -> str:
+    tag = f"v{version}"
+    local_tags = set(capture(["git", "tag", "--list", tag]).splitlines())
+    if tag not in local_tags and tag in remote_tags():
+        run(["git", "fetch", "origin", f"refs/tags/{tag}:refs/tags/{tag}"])
+        local_tags.add(tag)
+
+    if tag in local_tags:
+        tagged_commit = capture(["git", "rev-list", "-n", "1", tag])
+        if tagged_commit != commit:
+            raise SystemExit(
+                f"Refusing to reuse {tag}; it points at {tagged_commit}, not {commit}"
+            )
+        print(f"Tag {tag} already points at this commit.")
+    else:
+        run(["git", "tag", "-a", tag, "-m", message])
+        run(["git", "push", "origin", tag])
+    return tag
+
+
+def gitea_token() -> str:
+    token = "ed2db3fd54546e9658377d0551b3fc3961583f1d"
+
+    if not token:
+        raise SystemExit(
+            "GITEA_TOKEN is required to create the release and upload the APK. "
+            "Use --skip-release to push source/tag only."
+        )
+    return token
+
+
+def gitea_request(
+    path: str,
+    *,
+    token: str,
+    method: str = "GET",
+    body: bytes | None = None,
+    content_type: str = "application/json",
+    allow_not_found: bool = False,
+) -> dict[str, object] | list[object] | None:
+    request = urllib.request.Request(
+        f"{GITEA_API}{path}",
+        data=body,
+        method=method,
+        headers={
+            "Accept": "application/json",
+            "Authorization": f"token {token}",
+            "Content-Type": content_type,
+            "User-Agent": "i-want-to-heal-publisher",
+        },
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=90) as response:
+            payload = response.read()
+    except urllib.error.HTTPError as error:
+        details = error.read().decode(errors="replace")
+        if allow_not_found and error.code == 404:
+            return None
+        raise SystemExit(f"Gitea API {method} {path} failed ({error.code}): {details}") from error
+    return json.loads(payload) if payload else None
+
+
+def release_for_tag(tag: str, token: str) -> dict[str, object] | None:
+    result = gitea_request(
+        f"/repos/{GITEA_OWNER}/{GITEA_REPO}/releases/tags/{urllib.parse.quote(tag)}",
+        token=token,
+        allow_not_found=True,
+    )
+    return result if isinstance(result, dict) else None
+
+
+def create_release(tag: str, commit: str, message: str, token: str) -> dict[str, object]:
+    existing = release_for_tag(tag, token)
+    if existing:
+        print(f"Gitea release {tag} already exists.")
+        return existing
+
+    payload = json.dumps(
+        {
+            "tag_name": tag,
+            "target_commitish": commit,
+            "name": f"I Want To Heal {tag} — Thor test APK",
+            "body": (
+                f"{message}\n\n"
+                "Unsigned-for-store debug APK for sideload testing on AYN Thor. "
+                "Android debug signing is included; Play Store release signing is not."
+            ),
+            "draft": False,
+            "prerelease": True,
+        }
+    ).encode()
+    result = gitea_request(
+        f"/repos/{GITEA_OWNER}/{GITEA_REPO}/releases",
+        token=token,
+        method="POST",
+        body=payload,
+    )
+    if not isinstance(result, dict):
+        raise SystemExit("Gitea returned an invalid release response")
+    return result
+
+
+def multipart_asset(path: Path, media_type: str) -> tuple[bytes, str]:
+    boundary = f"----iwanttoheal{secrets.token_hex(12)}"
+    prefix = (
+        f"--{boundary}\r\n"
+        f'Content-Disposition: form-data; name="attachment"; filename="{path.name}"\r\n'
+        f"Content-Type: {media_type}\r\n\r\n"
+    ).encode()
+    body = prefix + path.read_bytes() + f"\r\n--{boundary}--\r\n".encode()
+    return body, f"multipart/form-data; boundary={boundary}"
+
+
+def upload_release_asset(
+    release_id: int,
+    path: Path,
+    *,
+    media_type: str,
+    token: str,
+) -> None:
+    body, content_type = multipart_asset(path, media_type)
+    gitea_request(
+        f"/repos/{GITEA_OWNER}/{GITEA_REPO}/releases/{release_id}/assets"
+        f"?name={urllib.parse.quote(path.name)}",
+        token=token,
+        method="POST",
+        body=body,
+        content_type=content_type,
+    )
+    print(f"Release asset uploaded: {path.name}")
+
+
+def upload_apk(release: dict[str, object], apk: Path, token: str) -> None:
+    assets = release.get("assets", [])
+    existing_names = {
+        str(asset.get("name"))
+        for asset in (assets if isinstance(assets, list) else [])
+        if isinstance(asset, dict)
+    }
+
+    release_id = release.get("id")
+    if not isinstance(release_id, int):
+        raise SystemExit("Gitea release response has no numeric id")
+    checksum = hashlib.sha256(apk.read_bytes()).hexdigest()
+    checksum_path = apk.with_name(f"{apk.name}.sha256")
+    checksum_path.write_text(f"{checksum}  {apk.name}\n")
+
+    release_assets = (
+        (apk, "application/vnd.android.package-archive"),
+        (checksum_path, "text/plain"),
+    )
+    for path, media_type in release_assets:
+        if path.name in existing_names:
+            print(f"Release asset {path.name} already exists.")
+        else:
+            upload_release_asset(
+                release_id,
+                path,
+                media_type=media_type,
+                token=token,
+            )
+    print(f"SHA-256: {checksum}")
 
 
 def update_truenas() -> None:
@@ -148,18 +422,26 @@ def update_truenas() -> None:
 def main(argv: list[str] | None = None) -> int:
     args = parse_args(sys.argv[1:] if argv is None else argv)
     ensure_git_target(dry_run=args.dry_run)
+    version = resolve_version(args.version)
+    message = args.message or f"Release v{version} {datetime.now():%Y-%m-%d}"
+    token = None if args.dry_run or args.skip_release else gitea_token()
 
-    if not args.skip_checks:
+    if not args.dry_run:
-        run_checks()
+        write_package_version(version)
+    apk = run_checks(version=version, skip_checks=args.skip_checks)
 
     if args.dry_run:
-        print("Dry run complete. No Git or TrueNAS state changed.")
+        print(f"Dry run complete for v{version}. No Git, Gitea, or TrueNAS state changed.")
         return 0
 
-    commit_and_push(args.message)
+    commit = commit_and_push(message)
+    tag = ensure_tag(version, commit, message)
+    if token:
+        release = create_release(tag, commit, message, token)
+        upload_apk(release, apk, token)
     if not args.skip_truenas:
         update_truenas()
-    print("Publish complete.")
+    print(f"Publish complete: {tag}")
     return 0
 
 

src/App.tsx

@@ -1,4 +1,5 @@
 import { lazy, Suspense, useCallback, useEffect, useRef } from "react";
+import packageJson from "../package.json";
 import { DualDisplayFrame } from "./components/DualDisplayFrame";
 import { FrontEnd } from "./components/FrontEnd";
 import { useActiveHunter, useFrontendStore } from "./frontend/store";
@@ -63,7 +64,7 @@ export default function App() {
     <main className="prototype-shell">
       <header className="prototype-header">
         <div><span>THOR / DUAL DISPLAY</span><strong>I Want To Heal</strong></div>
-        <p>Offline-first healer roguelike <i /> build 0.2</p>
+        <p>Offline-first healer roguelike <i /> v{packageJson.version}</p>
       </header>
       {screen === "game"
         ? <Suspense fallback={<GameLoadingScreen />}><DualDisplayFrame top={<TopScreen onExit={leaveGame} />} bottom={<BottomScreen />} /></Suspense>

src/components/DualDisplayFrame.tsx

@@ -1,13 +1,51 @@
-import type { ReactNode } from "react";
+import { useEffect, useRef, useState, type ReactNode } from "react";
+import { subscribeDisplaySurface, type DisplaySurface } from "../platform/displayRouting";
 
 export function DualDisplayFrame({ top, bottom }: { top: ReactNode; bottom: ReactNode }) {
+  const [activeSurface, setActiveSurface] = useState<DisplaySurface>("top");
+  const activeSurfaceRef = useRef(activeSurface);
+  activeSurfaceRef.current = activeSurface;
+
+  useEffect(() => {
+    if (!document.documentElement.classList.contains("native-platform")) return;
+    let frame = 0;
+    let selectHeld = false;
+    const toggle = () => setActiveSurface((surface) => surface === "top" ? "bottom" : "top");
+    const unsubscribeSurface = subscribeDisplaySurface(setActiveSurface);
+    const onKeyDown = (event: KeyboardEvent) => {
+      if (event.key !== "Tab" || event.repeat) return;
+      event.preventDefault();
+      toggle();
+    };
+    const poll = () => {
+      const held = navigator.getGamepads?.()[0]?.buttons[8]?.pressed ?? false;
+      if (held && !selectHeld) toggle();
+      selectHeld = held;
+      frame = requestAnimationFrame(poll);
+    };
+    window.addEventListener("keydown", onKeyDown);
+    frame = requestAnimationFrame(poll);
+    return () => {
+      window.removeEventListener("keydown", onKeyDown);
+      unsubscribeSurface();
+      cancelAnimationFrame(frame);
+    };
+  }, []);
+
   return (
-    <div className="device-frame">
+    <div className={`device-frame active-${activeSurface}`}>
       <div className="screen-label"><span>Main viewport</span><small>960 × 540 CSS · 1920 × 1080 · 120Hz</small></div>
-      {top}
+      <div className={`surface-slot top-slot ${activeSurface === "top" ? "is-active" : ""}`}>{top}</div>
       <div className="hinge" aria-hidden="true"><i /><b>AYN THOR</b><i /></div>
       <div className="screen-label bottom-label"><span>Context display</span><small>620 × 540 CSS · 1240 × 1080 · 60Hz</small></div>
-      {bottom}
+      <div className={`surface-slot bottom-slot ${activeSurface === "bottom" ? "is-active" : ""}`}>{bottom}</div>
+      <button
+        className="native-display-switch"
+        onClick={() => setActiveSurface(activeSurfaceRef.current === "top" ? "bottom" : "top")}
+        aria-label={activeSurface === "top" ? "Open tactical display" : "Return to main display"}
+      >
+        <b>{activeSurface === "top" ? "Tactical" : "Main"}</b><small>SELECT / TAB</small>
+      </button>
     </div>
   );
 }

src/components/FrontEnd.tsx

@@ -7,6 +7,7 @@ import { useMenuController, type MenuAction } from "../input/useMenuController";
 import { HEALER_CLASSES, HEALER_CLASS_ORDER } from "../game/healers";
 import { BOSS_DEFINITIONS, BOSS_ORDER } from "../game/bossCatalog";
 import type { BossId } from "../game/types";
+import { requestDisplaySurface } from "../platform/displayRouting";
 import { DualDisplayFrame } from "./DualDisplayFrame";
 
 function FocusButton({
@@ -151,6 +152,11 @@ function SaveScreen() {
   const openCreation = () => {
     setHunterName("");
     setDialog("create");
+    requestDisplaySurface("top");
+  };
+  const openSaveDialog = (nextDialog: "copy" | "delete") => {
+    setDialog(nextDialog);
+    requestDisplaySurface("top");
   };
 
   const actions = useMemo<MenuAction[]>(() => dialog === "create"
@@ -170,8 +176,8 @@ function SaveScreen() {
           { id: hasLocal ? "play" : "create", run: () => hasLocal ? playSlot(selectedSlotId) : openCreation() },
           { id: "upload", run: () => uploadSlot(selectedSlotId), enabled: hasLocal && Boolean(accountId) },
           { id: "download", run: () => downloadSlot(selectedSlotId), enabled: hasOnline && Boolean(accountId) },
-          { id: "copy", run: () => setDialog("copy"), enabled: hasLocal },
+          { id: "copy", run: () => openSaveDialog("copy"), enabled: hasLocal },
-          { id: "delete", run: () => setDialog("delete"), enabled: hasLocal },
+          { id: "delete", run: () => openSaveDialog("delete"), enabled: hasLocal },
           { id: "back", run: () => navigate("login") },
         ], [accountId, copySlot, createSlot, deleteSlot, dialog, downloadSlot, hasLocal, hasOnline, hunterName, navigate, playSlot, selectSlot, selectedSlotId, slots, uploadSlot]);
   const controller = useMenuController(actions, { onBack: () => dialog ? setDialog(null) : navigate("login") });
@@ -261,8 +267,8 @@ function SaveScreen() {
               <FocusButton id="download" focusedId={controller.focusedId} focus={controller.focus} disabled={!hasOnline || !accountId} onClick={() => downloadSlot(selectedSlotId)}>↓ Overwrite with online</FocusButton>
             </div>
             <div className="record-actions">
-              <FocusButton id="copy" focusedId={controller.focusedId} focus={controller.focus} disabled={!hasLocal} onClick={() => setDialog("copy")}>Copy save</FocusButton>
+              <FocusButton id="copy" focusedId={controller.focusedId} focus={controller.focus} disabled={!hasLocal} onClick={() => openSaveDialog("copy")}>Copy save</FocusButton>
-              <FocusButton id="delete" focusedId={controller.focusedId} focus={controller.focus} disabled={!hasLocal} className="danger-link" onClick={() => setDialog("delete")}>Delete save</FocusButton>
+              <FocusButton id="delete" focusedId={controller.focusedId} focus={controller.focus} disabled={!hasLocal} className="danger-link" onClick={() => openSaveDialog("delete")}>Delete save</FocusButton>
               <FocusButton id="back" focusedId={controller.focusedId} focus={controller.focus} onClick={() => navigate("login")}>Back</FocusButton>
             </div>
           </div>

src/main.tsx

@@ -1,8 +1,15 @@
 import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
+import { Capacitor } from "@capacitor/core";
 import App from "./App";
 import "./styles.css";
 
+const nativeLayoutRequested = new URLSearchParams(window.location.search).has("nativeLayout");
+
+if (Capacitor.isNativePlatform() || nativeLayoutRequested) {
+  document.documentElement.classList.add("native-platform");
+}
+
 createRoot(document.getElementById("root")!).render(
   <StrictMode>
     <App />

src/platform/displayRouting.ts

@@ -0,0 +1,13 @@
+export type DisplaySurface = "top" | "bottom";
+
+const DISPLAY_SURFACE_EVENT = "thor:display-surface";
+
+export function requestDisplaySurface(surface: DisplaySurface) {
+  window.dispatchEvent(new CustomEvent<DisplaySurface>(DISPLAY_SURFACE_EVENT, { detail: surface }));
+}
+
+export function subscribeDisplaySurface(listener: (surface: DisplaySurface) => void) {
+  const onSurface = (event: Event) => listener((event as CustomEvent<DisplaySurface>).detail);
+  window.addEventListener(DISPLAY_SURFACE_EVENT, onSurface);
+  return () => window.removeEventListener(DISPLAY_SURFACE_EVENT, onSurface);
+}

src/styles.css

@@ -108,6 +108,15 @@ button:focus-visible {
   align-items: center;
 }
 
+.surface-slot {
+  width: 100%;
+  display: contents;
+}
+
+.native-display-switch {
+  display: none;
+}
+
 .screen-label {
   width: 100%;
   display: flex;
@@ -1231,6 +1240,101 @@ button:focus-visible {
   }
 }
 
+/* Capacitor single-display fallback. Thor dual-display routing will replace this
+   switcher once both Android display contexts share one authoritative game state. */
+.native-platform,
+.native-platform body,
+.native-platform #root,
+.native-platform .prototype-shell,
+.native-platform .device-frame {
+  width: 100%;
+  height: 100%;
+  min-height: 100%;
+  overflow: hidden;
+}
+
+.native-platform .prototype-shell {
+  padding: 0;
+}
+
+.native-platform .prototype-header,
+.native-platform .screen-label,
+.native-platform .hinge {
+  display: none;
+}
+
+.native-platform .device-frame {
+  position: relative;
+  display: block;
+  max-width: none;
+}
+
+.native-platform .surface-slot {
+  position: absolute;
+  inset: 0;
+  display: none;
+  place-items: center;
+  background: #030706;
+}
+
+.native-platform .surface-slot.is-active {
+  display: grid;
+}
+
+.native-platform .top-slot > .display {
+  width: 100%;
+  height: 100%;
+  aspect-ratio: auto;
+}
+
+.native-platform .bottom-slot > .display {
+  width: min(620px, 100%);
+  height: 100%;
+  aspect-ratio: auto;
+}
+
+.native-platform .display {
+  border: 0;
+  border-radius: 0;
+  box-shadow: none;
+}
+
+.native-platform .native-display-switch {
+  position: fixed;
+  right: max(10px, env(safe-area-inset-right));
+  bottom: max(8px, env(safe-area-inset-bottom));
+  z-index: 100;
+  display: grid;
+  min-width: 76px;
+  padding: 5px 8px;
+  border: 1px solid rgba(232, 200, 114, 0.55);
+  border-radius: 3px;
+  color: var(--ink);
+  background: rgba(3, 9, 8, 0.9);
+  text-align: left;
+}
+
+.native-platform .device-frame.active-bottom .native-display-switch {
+  top: max(7px, env(safe-area-inset-top));
+  right: auto;
+  bottom: auto;
+  left: 50%;
+  transform: translateX(-50%);
+}
+
+.native-platform .native-display-switch b {
+  color: var(--gold-strong);
+  font-size: 9px;
+  line-height: 1;
+  text-transform: uppercase;
+}
+
+.native-platform .native-display-switch small {
+  color: var(--muted);
+  font-size: 6px;
+  line-height: 1.2;
+}
+
 /* Frontend shell — I Want To Heal */
 
 .front-surface {