[codex] Add Android mobile support

app.json

@@ -0,0 +1,3 @@
+{
+  "expo": {}
+}

apps/mobile/README.md

@@ -34,6 +34,30 @@ Build and run the local iOS dev client:
 vp run ios:dev
 ```
 
+If your Xcode account only has a Personal Team, use a bundle identifier you control and opt into the
+reduced-capability local build. Personal Team builds omit the widget extension, push entitlement, and
+native Sign in with Apple entitlement; builds without this opt-in are unchanged.
+
+```bash
+T3CODE_IOS_PERSONAL_TEAM=1 \
+T3CODE_IOS_PERSONAL_TEAM_BUNDLE_ID=com.example.t3code.dev \
+vp run ios:dev
+```
+
+Build and install a self-contained Release app that does not need Metro:
+
+```bash
+vp run ios:release
+```
+
+The Personal Team equivalent also needs a unique bundle identifier:
+
+```bash
+T3CODE_IOS_PERSONAL_TEAM=1 \
+T3CODE_IOS_PERSONAL_TEAM_BUNDLE_ID=com.example.t3code \
+vp run ios:release
+```
+
 Build and run the local iOS preview app:
 
 ```bash

apps/mobile/app.config.ts

 appleTeamId: "ARK85ZXQ4Z", 
 appleTeamId: "ARK85ZXQ4Z", 
@@ -8,6 +8,20 @@ const repoEnv = loadRepoEnv();
 Object.assign(process.env, repoEnv);
 
 const APP_VARIANT = resolveAppVariant(repoEnv.APP_VARIANT);
+const isIosPersonalTeamBuild = repoEnv.T3CODE_IOS_PERSONAL_TEAM === "1";
+
+const personalTeamBundleIdentifier = repoEnv.T3CODE_IOS_PERSONAL_TEAM_BUNDLE_ID?.trim();
+const IOS_BUNDLE_IDENTIFIER_PATTERN = /^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/;
+
+if (
+  isIosPersonalTeamBuild &&
+  (!personalTeamBundleIdentifier ||
+    !IOS_BUNDLE_IDENTIFIER_PATTERN.test(personalTeamBundleIdentifier))
+) {
+  throw new Error(
+    "T3CODE_IOS_PERSONAL_TEAM_BUNDLE_ID must be a reverse-DNS identifier such as com.example.t3code when T3CODE_IOS_PERSONAL_TEAM=1.",
+  );
+}
 
 const VARIANT_CONFIG: Record<
   AppVariant,
@@ -69,6 +83,26 @@ const dmSansFonts = {
   bold: "@expo-google-fonts/dm-sans/700Bold/DMSans_700Bold.ttf",
 } as const;
 
+const widgetsPlugin: NonNullable<ExpoConfig["plugins"]>[number] = [
+  "expo-widgets",
+  {
+    bundleIdentifier: `${variant.iosBundleIdentifier}.widgets`,
+    groupIdentifier: `group.${variant.iosBundleIdentifier}`,
+    enablePushNotifications: true,
+    // Agent activity can update many times an hour; without the
+    // frequent-updates entitlement iOS throttles the update budget sooner.
+    frequentUpdates: true,
+    widgets: [
+      {
+        name: "AgentActivity",
+        displayName: "Agent Activity",
+        description: "Shows the current state of active T3 Code agents.",
+        supportedFamilies: ["systemSmall", "systemMedium", "accessoryRectangular"],
+      },
+    ],
+  },
+];
+
 // These aliases match the fonts' PostScript names on iOS. Register the same
 // names on Android so React Native and the native composer use one set of
 // family names without waiting for runtime font loading.
@@ -125,12 +159,16 @@ const config: ExpoConfig = {
       backgroundImage: "./assets/android-icon-background.png",
       monochromeImage: "./assets/android-icon-monochrome.png",
     },
-    predictiveBackGestureEnabled: false,
+    // Opts into OnBackInvokedCallback-based back dispatch (Android 13+).
+    // JS back handling survives it via react-native's Android 16 shim plus
+    // withAndroidPredictiveBackCompat on Android 13-15.
+    predictiveBackGestureEnabled: true,
   },
   web: {
     favicon: "./assets/favicon.png",
   },
   plugins: [
+    "expo-asset",
     [
       "expo-font",
       {
@@ -157,8 +195,23 @@ const config: ExpoConfig = {
     ],
     "expo-secure-store",
     "expo-sqlite",
-    ["@clerk/expo", { theme: "./clerk-theme.json" }],
+    // appleSignIn must be gated here: withoutIosPersonalTeamCapabilities.cjs runs before
+    // plugins earlier in this array, so it cannot strip the entitlement Clerk would add.
+    ["@clerk/expo", { theme: "./clerk-theme.json", appleSignIn: !isIosPersonalTeamBuild }],
     "expo-web-browser",
+    [
+      "expo-quick-actions",
+      {
+        // Adaptive launcher-shortcut icon; referenced by resource name from
+        // the shortcut items set in src/features/shortcuts.
+        androidIcons: {
+          shortcut_icon: {
+            foregroundImage: "./assets/android-icon-foreground.png",
+            backgroundColor: "#E6F4FE",
+          },
+        },
+      },
+    ],
     [
       "expo-camera",
       {
@@ -198,31 +251,18 @@ const config: ExpoConfig = {
     // expo-widgets' — its dangerous mod wipes ios/ExpoWidgetsTarget/ (which
     // would delete the asset catalog) and its xcodeproj mod creates the widget
     // target (which must exist before the compile phase can be attached).
-    "./plugins/withWidgetLogoAsset.cjs",
-    [
-      "expo-widgets",
-      {
-        bundleIdentifier: `${variant.iosBundleIdentifier}.widgets`,
-        groupIdentifier: `group.${variant.iosBundleIdentifier}`,
-        enablePushNotifications: true,
-        // Agent activity can update many times an hour; without the
-        // frequent-updates entitlement iOS throttles the update budget sooner.
-        frequentUpdates: true,
-        widgets: [
-          {
-            name: "AgentActivity",
-            displayName: "Agent Activity",
-            description: "Shows the current state of active T3 Code agents.",
-            supportedFamilies: ["systemSmall", "systemMedium", "accessoryRectangular"],
-          },
-        ],
-      },
-    ],
+    ...(!isIosPersonalTeamBuild ? ["./plugins/withWidgetLogoAsset.cjs", widgetsPlugin] : []),
     "./plugins/withIosSceneLifecycle.cjs",
     "./plugins/withAndroidCleartextTraffic.cjs",
+    "./plugins/withAndroidGradleHeap.cjs",
+    "./plugins/withAndroidModernPopupMenu.cjs",
+    "./plugins/withAndroidModernAlertDialog.cjs",
+    "./plugins/withAndroidPredictiveBackCompat.cjs",
+    ...(isIosPersonalTeamBuild ? ["./plugins/withoutIosPersonalTeamCapabilities.cjs"] : []),
   ],
   extra: {
     appVariant: APP_VARIANT,
+    iosPersonalTeamBuild: isIosPersonalTeamBuild,
     relay: {
       url: repoEnv.T3CODE_RELAY_URL ?? null,
     },

apps/mobile/global.css

@@ -12,7 +12,7 @@
       /* Card / surface */
       --color-card: #ffffff;
       --color-card-alt: #f5f5f5;
-      --color-card-translucent: rgba(255, 255, 255, 0.94);
+      --color-card-translucent: rgba(255, 255, 255, 0.8);
 
       /* Text */
       --color-foreground: #262626;
@@ -106,7 +106,7 @@
       /* Card / surface */
       --color-card: #171717;
       --color-card-alt: #1c1c1c;
-      --color-card-translucent: rgba(17, 17, 17, 0.94);
+      --color-card-translucent: rgba(17, 17, 17, 0.8);
 
       /* Text */
       --color-foreground: #f5f5f5;

apps/mobile/metro.config.js

@@ -6,6 +6,7 @@ const { withUniwindConfig } = require("uniwind/metro");
 /** @type {import("expo/metro-config").MetroConfig} */
 const config = getDefaultConfig(__dirname);
 const workspaceRoot = path.resolve(__dirname, "../..");
+const escapedWorkspaceRoot = workspaceRoot.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 const mobileShikiRoot = path.dirname(require.resolve("shiki/package.json", { paths: [__dirname] }));
 const resolveShikiDependencyRoot = (packageName) => {
   const entryPath = require.resolve(packageName, { paths: [mobileShikiRoot] });
@@ -25,6 +26,14 @@ const resolveShikiDependencyRoot = (packageName) => {
 config.watchFolders = [...new Set([...(config.watchFolders ?? []), workspaceRoot])];
 config.resolver = {
   ...config.resolver,
+  blockList: [
+    ...(Array.isArray(config.resolver?.blockList)
+      ? config.resolver.blockList
+      : config.resolver?.blockList
+        ? [config.resolver.blockList]
+        : []),
+    new RegExp(`${escapedWorkspaceRoot}[/\\\\]\\.t3[/\\\\].*`),
+  ],
   extraNodeModules: {
     // oxlint-disable-next-line unicorn/no-useless-fallback-in-spread
     ...(config.resolver?.extraNodeModules ?? {}),

apps/mobile/modules/t3-composer-editor/android/build.gradle

@@ -0,0 +1,19 @@
+apply plugin: 'com.android.library'
+apply plugin: 'org.jetbrains.kotlin.android'
+
+group = 'com.t3tools.composereditor'
+version = '0.0.0'
+
+android {
+  namespace 'expo.modules.t3composereditor'
+  compileSdk rootProject.ext.compileSdkVersion
+
+  defaultConfig {
+    minSdkVersion rootProject.ext.minSdkVersion
+    targetSdkVersion rootProject.ext.targetSdkVersion
+  }
+}
+
+dependencies {
+  implementation project(':expo-modules-core')
+}

apps/mobile/modules/t3-composer-editor/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

apps/mobile/modules/t3-composer-editor/android/src/main/java/expo/modules/t3composereditor/T3ComposerEditorModule.kt

@@ -0,0 +1,72 @@
+package expo.modules.t3composereditor
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class T3ComposerEditorModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("T3ComposerEditor")
+
+    View(T3ComposerEditorView::class) {
+      Prop("controlledDocumentJson") { view: T3ComposerEditorView, documentJson: String ->
+        view.setControlledDocumentJson(documentJson)
+      }
+      Prop("themeJson") { view: T3ComposerEditorView, themeJson: String ->
+        view.setThemeJson(themeJson)
+      }
+      Prop("placeholder") { view: T3ComposerEditorView, placeholder: String ->
+        view.setPlaceholder(placeholder)
+      }
+      Prop("fontFamily") { view: T3ComposerEditorView, fontFamily: String ->
+        view.setFontFamily(fontFamily)
+      }
+      Prop("fontSize") { view: T3ComposerEditorView, fontSize: Double ->
+        view.setFontSize(fontSize.toFloat())
+      }
+      Prop("lineHeight") { view: T3ComposerEditorView, lineHeight: Double ->
+        view.setLineHeight(lineHeight.toFloat())
+      }
+      Prop("contentInsetVertical") { view: T3ComposerEditorView, contentInsetVertical: Double ->
+        view.setContentInsetVertical(contentInsetVertical.toInt())
+      }
+
+      Prop("singleLineCentered") { view: T3ComposerEditorView, singleLineCentered: Boolean ->
+        view.setSingleLineCentered(singleLineCentered)
+      }
+      Prop("editable") { view: T3ComposerEditorView, editable: Boolean ->
+        view.setEditable(editable)
+      }
+      Prop("scrollEnabled") { view: T3ComposerEditorView, scrollEnabled: Boolean ->
+        view.setScrollEnabled(scrollEnabled)
+      }
+      Prop("autoFocus") { view: T3ComposerEditorView, autoFocus: Boolean ->
+        view.setAutoFocus(autoFocus)
+      }
+      Prop("autoCorrect") { view: T3ComposerEditorView, autoCorrect: Boolean ->
+        view.setAutoCorrect(autoCorrect)
+      }
+      Prop("spellCheck") { view: T3ComposerEditorView, spellCheck: Boolean ->
+        view.setSpellCheck(spellCheck)
+      }
+
+      Events(
+        "onComposerChange",
+        "onComposerSelectionChange",
+        "onComposerFocus",
+        "onComposerBlur",
+        "onComposerPasteImages",
+        "onComposerContentSizeChange",
+      )
+
+      AsyncFunction("focus") { view: T3ComposerEditorView ->
+        view.focusEditor()
+      }
+      AsyncFunction("blur") { view: T3ComposerEditorView ->
+        view.blurEditor()
+      }
+      AsyncFunction("setSelection") { view: T3ComposerEditorView, start: Int, end: Int ->
+        view.setSelection(start, end)
+      }
+    }
+  }
+}