T3 Code Mobile [WIP]

.github/workflows/ci.yml

@@ -74,6 +74,33 @@ jobs:
           test -f apps/desktop/dist-electron/preload.cjs
           grep -nE "desktopBridge|getLocalEnvironmentBootstrap|PICK_FOLDER_CHANNEL|wsUrl" apps/desktop/dist-electron/preload.cjs
 
+  mobile_native_static_analysis:
+    name: Mobile Native Static Analysis
+    runs-on: blacksmith-12vcpu-macos-26
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version-file: package.json
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: package.json
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Install mobile native static analysis tools
+        run: brew bundle install --file apps/mobile/Brewfile
+
+      - name: Lint mobile native sources
+        run: node scripts/mobile-native-static-check.ts
+
   release_smoke:
     name: Release Smoke
     runs-on: blacksmith-8vcpu-ubuntu-2404

.oxfmtrc.json

@@ -9,8 +9,11 @@
     "bun.lock",
     "*.tsbuildinfo",
     "**/routeTree.gen.ts",
+    "apps/mobile/android/**",
+    "apps/mobile/ios/**",
     "apps/web/public/mockServiceWorker.js",
     "apps/web/src/lib/vendor/qrcodegen.ts",
+    "apps/mobile/uniwind-types.d.ts",
     "*.icon/**"
   ],
   "sortPackageJson": {},

.oxlintrc.json

@@ -6,7 +6,10 @@
     "node_modules",
     "bun.lock",
     "*.tsbuildinfo",
-    "**/routeTree.gen.ts"
+    "**/routeTree.gen.ts",
+    "apps/mobile/android/**",
+    "apps/mobile/ios/**",
+    "apps/mobile/uniwind-types.d.ts"
   ],
   "plugins": ["eslint", "oxc", "react", "unicorn", "typescript"],
   "jsPlugins": ["./oxlint-plugin-t3code/index.ts"],
@@ -16,6 +19,7 @@
     "perf": "warn"
   },
   "rules": {
+    "unicorn/no-array-sort": "off",
     "react-in-jsx-scope": "off",
     "eslint/no-shadow": "off",
     "eslint/no-await-in-loop": "off",

AGENTS.md

@@ -3,6 +3,7 @@
 ## Task Completion Requirements
 
 - All of `bun fmt`, `bun lint`, and `bun typecheck` must pass before considering tasks completed.
+  - If changing native mobile code, `bun lint:mobile` must also pass.
 - NEVER run `bun test`. Always use `bun run test` (runs Vitest).
 
 ## Project Snapshot

apps/mobile/.editorconfig

@@ -0,0 +1,12 @@
+root = false
+
+[*.{kt,kts}]
+indent_size = 2
+ktlint_code_style = android_studio
+ktlint_standard_blank-line-between-when-conditions = disabled
+ktlint_standard_class-signature = disabled
+ktlint_standard_function-signature = disabled
+ktlint_standard_import-ordering = disabled
+ktlint_standard_multiline-expression-wrapping = disabled
+ktlint_standard_trailing-comma-on-call-site = disabled
+ktlint_standard_when-entry-bracing = disabled

apps/mobile/.gitignore

@@ -0,0 +1,41 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+# generated native folders
+/ios
+/android

apps/mobile/.swiftlint.yml

@@ -0,0 +1,58 @@
+included:
+  - ios/T3Code
+  - modules/t3-terminal/ios
+  - modules/t3-review-diff/ios
+
+excluded:
+  - ios/Pods
+  - ios/build
+  - modules/t3-terminal/Vendor
+
+reporter: xcode
+
+disabled_rules:
+  - file_length
+  - function_body_length
+  - identifier_name
+  - line_length
+  - lower_acl_than_parent
+  - modifier_order
+  - trailing_comma
+  - type_body_length
+
+opt_in_rules:
+  - array_init
+  - closure_end_indentation
+  - closure_spacing
+  - collection_alignment
+  - contains_over_filter_count
+  - contains_over_filter_is_empty
+  - contains_over_first_not_nil
+  - contains_over_range_nil_comparison
+  - empty_collection_literal
+  - empty_count
+  - empty_string
+  - enum_case_associated_values_count
+  - fallthrough
+  - fatal_error_message
+  - first_where
+  - flatmap_over_map_reduce
+  - force_unwrapping
+  - implicitly_unwrapped_optional
+  - last_where
+  - legacy_multiple
+  - legacy_random
+  - operator_usage_whitespace
+  - overridden_super_call
+  - prefer_self_type_over_type_of_self
+  - private_action
+  - private_outlet
+  - prohibited_super_call
+  - reduce_into
+  - redundant_nil_coalescing
+  - sorted_first_last
+  - static_operator
+  - toggle_bool
+  - unneeded_parentheses_in_closure_argument
+  - vertical_parameter_alignment_on_call
+  - yoda_condition

apps/mobile/Brewfile

@@ -0,0 +1,3 @@
+brew "swiftlint"
+brew "ktlint"
+brew "detekt"

apps/mobile/README.md

@@ -0,0 +1,81 @@
+# T3 Code Mobile
+
+> [!WARNING]
+> T3 Code Mobile is currently in development and is not distributed yet. If you want to try it out, you can build it from source.
+
+## Quickstart
+
+> [!NOTE]
+> Uses native modules so using Expo Go is not supported. You need to use the Expo Dev Client.
+
+This app has three variants:
+
+- `development`: Expo dev client, installable side-by-side as `T3 Code Dev`
+- `preview`: persistent internal preview build, installable side-by-side as `T3 Code Preview`
+- `production`: store/release build as `T3 Code`
+
+Run commands from `apps/mobile`.
+
+## Development
+
+Start Metro for the dev client:
+
+```bash
+bun run dev:client
+```
+
+Build and run the local iOS dev client:
+
+```bash
+bun run ios:dev
+```
+
+Build and run the local iOS preview app:
+
+```bash
+bun run ios:preview
+```
+
+Force the review diff highlighter engine:
+
+```bash
+EXPO_PUBLIC_REVIEW_HIGHLIGHTER_ENGINE=javascript bun run ios:dev
+```
+
+`javascript` is the default and recommended setting for the review diff screen. Set `EXPO_PUBLIC_REVIEW_HIGHLIGHTER_ENGINE=native` only when you explicitly want to test the native Shiki engine.
+
+Inspect the resolved Expo config for a variant:
+
+```bash
+bun run config:dev
+bun run config:preview
+```
+
+Run static checks for mobile native code:
+
+```bash
+node ../../scripts/mobile-native-static-check.ts
+```
+
+The native lint task runs SwiftLint for Swift plus ktlint and detekt for Kotlin. Missing native tools are reported as warnings and skipped locally. CI installs the default toolset from `apps/mobile/Brewfile` before running the native checks.
+
+## EAS Builds
+
+Create a cloud dev-client build:
+
+```bash
+bun run eas:ios:dev
+```
+
+Create a persistent preview build:
+
+```bash
+bun run eas:ios:preview
+```
+
+Android equivalents:
+
+```bash
+bun run eas:android:dev
+bun run eas:android:preview
+```