massalabs
diff --git a/‎.env.example‎
Lines changed: 11 additions & 0 deletions b/‎.env.example‎
Lines changed: 11 additions & 0 deletions
diff --git a/‎.github/workflows/tests.yml‎
Lines changed: 31 additions & 10 deletions b/‎.github/workflows/tests.yml‎
Lines changed: 31 additions & 10 deletions
diff --git a/‎.gitignore‎
Lines changed: 3 additions & 2 deletions b/‎.gitignore‎
Lines changed: 3 additions & 2 deletions
diff --git a/‎DEV-GUIDE.md‎
Lines changed: 138 additions & 0 deletions b/‎DEV-GUIDE.md‎
Lines changed: 138 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 80 additions & 0 deletions b/‎README.md‎
Lines changed: 80 additions & 0 deletions
@@ -0,0 +1,11 @@
+VITE_GOSSIP_API_URL=
+VITE_INVITE_DOMAIN=
+VITE_APP_BUILD_ID=
+# Set to auto-login in dev mode (skip password prompt on hot reload)
+# VITE_DEV_PASSWORD=devdevde
+# Dev accounts: auto-restore from mnemonic on first launch (pick identity per device)
+# VITE_DEV_ACCOUNTS=[{"name":"Alice","mnemonic":"abandon abandon ..."},{"name":"Bob","mnemonic":"zoo zoo ..."}]
+
+# Device targets for cap:dev:all (comma-separated for multiple devices)
+# ANDROID_DEVICES=10.26.239.15:5555,10.26.239.20:5555
+# IOS_DEVICES=iPhone de Ben
@@ -5,31 +5,52 @@ on:
     branches: [main, dev]
 
 jobs:
-  test:
+  sdk-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+
+      - run: npm ci
+
+      - name: Run gossip-sdk tests
+        run: npm --workspace gossip-sdk test
+
+  app-tests:
     runs-on: ubuntu-latest
     env:
       VITE_GOSSIP_API_URL: ${{ vars.GOSSIP_API_URL }}
       VITE_INVITE_DOMAIN: ${{ vars.INVITE_DOMAIN_DEV }}
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: '24'
           cache: 'npm'
 
-      - name: Install dependencies
-        run: npm ci
+      - run: npm ci
+
+      - name: Cache Playwright browsers
+        id: playwright-cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ hashFiles('**/package-lock.json') }}
 
       - name: Install Playwright browsers
+        if: steps.playwright-cache.outputs.cache-hit != 'true'
         run: npx playwright install --with-deps chromium
 
+      - name: Install Playwright deps (cached)
+        if: steps.playwright-cache.outputs.cache-hit == 'true'
+        run: npx playwright install-deps chromium
+
       - name: Run tests
         run: |
           npm run build
           npm run test:run
-
-      - name: Run gossip-sdk tests
-        run: npm --workspace gossip-sdk test
 
@@ -75,5 +75,6 @@ android/app/src/main/res/mipmap-*/ic_launcher_background.png
 # Test artifacts
 test/**/__screenshots__/
 
-# Git worktrees
-.worktrees/
+# Git worktrees & Claude Code
+.worktrees/
+.claude/
@@ -0,0 +1,138 @@
+# Gossip App — Wireless Dev Mode Guide
+
+Hot reload over Wi-Fi on Android and iOS, with an optional Gossip bot for remote control.
+
+## Quick Start
+
+### Android only
+
+```bash
+npm run cap:dev:android -- 10.26.239.15:5555
+```
+
+### iOS only
+
+```bash
+npm run cap:dev:ios
+# → Opens Xcode. Select your iPhone → Cmd+R
+# (Vite starts automatically, hot reload is active)
+```
+
+### Both platforms
+
+```bash
+npm run cap:dev:all -- "10.26.239.15:5555"
+# → Android deploys via ADB, iOS opens Xcode for manual run
+```
+
+## Prerequisites
+
+### Network
+
+- Phone(s) and Mac on the **same Wi-Fi network**
+- Android: ADB Wi-Fi connected (`adb connect <ip>:5555`)
+- iOS: Wi-Fi debugging enabled in Xcode (Window → Devices and Simulators → Connect via network)
+
+### One-time iOS setup
+
+1. Install the mkcert root CA on your iPhone:
+   - AirDrop `~/.vite-plugin-mkcert/rootCA.pem` to your phone
+   - Settings → General → VPN & Device Management → install the profile
+   - Settings → General → About → Certificate Trust Settings → enable full trust
+
+2. Ensure Xcode has your device set up for Wi-Fi debugging
+
+### One-time Android setup
+
+```bash
+adb tcpip 5555
+adb connect <phone-ip>:5555
+```
+
+## How It Works
+
+### The dev scripts
+
+All scripts follow the same flow:
+
+1. Detect local IP address
+2. Build the SDK (`npm run build:sdk`)
+3. Set `DEV_SERVER_URL=https://<local-ip>:5173`
+4. Run `cap sync` (writes the dev server URL into the Capacitor config)
+5. Deploy to device (or open Xcode for iOS)
+6. Start Vite HTTPS dev server (`npx vite --host`)
+
+The WebView loads from the Vite server instead of bundled files → any code change triggers hot reload.
+
+### SSL handling
+
+The Vite server uses HTTPS (required for `crypto.subtle`). Self-signed certs need bypass on both platforms:
+
+**Android** (already in repo):
+
+- `MainActivity.java`: `BridgeWebViewClient` subclass that accepts all certs in debug
+- `network_security_config.xml`: trusts user-installed CAs in debug
+
+**iOS** (3 layers, belt-and-suspenders):
+
+1. `patches/@capacitor+ios+8.0.0.patch` — patches `WebViewDelegationHandler.swift` to accept self-signed certs (persisted via `patch-package`, applied on `npm install`)
+2. `ios/App/App/SSLBypassPlugin.swift` — Capacitor plugin registered in debug builds only
+3. `ios/App/App/Info.plist` — `WKAppBoundDomains` removed (blocks localStorage on non-listed domains)
+
+### Key files
+
+| File                                              | Purpose                                   |
+| ------------------------------------------------- | ----------------------------------------- |
+| `scripts/dev-android.sh`                          | Android hot reload script                 |
+| `scripts/dev-ios.sh`                              | iOS hot reload script                     |
+| `scripts/dev-all.sh`                              | Both platforms simultaneously             |
+| `capacitor.config.ts`                             | Reads `DEV_SERVER_URL` env var            |
+| `patches/@capacitor+ios+8.0.0.patch`              | SSL bypass patch for Capacitor iOS        |
+| `ios/App/App/SSLBypassPlugin.swift`               | SSL bypass Capacitor plugin (debug only)  |
+| `ios/App/App/MyViewController.swift`              | Plugin registration + WebView inspectable |
+| `android/app/src/main/java/.../MainActivity.java` | SSL bypass for Android (debug only)       |
+
+## Troubleshooting
+
+### iOS black screen
+
+This means the WebView can't load from the dev server (SSL rejection).
+
+1. Verify the patch is applied: check `node_modules/@capacitor/ios/Capacitor/Capacitor/WebViewDelegationHandler.swift` for "patched by gossip-app" comment
+2. If not applied: `npx patch-package` or `npm install` (postinstall hook runs it)
+3. After patching: `npx cap sync ios`, then clean build in Xcode (Cmd+Shift+K → Cmd+R)
+4. Nuclear option: delete `~/Library/Developer/Xcode/DerivedData` and rebuild
+
+### `cap sync` removed the dev server URL
+
+Never run `cap sync` without `DEV_SERVER_URL` set. Always use the dev scripts which set it automatically.
+
+### Safari Web Inspector doesn't show the app
+
+- Ensure `bridge?.webView?.isInspectable = true` is set in `MyViewController.swift` (under `#if DEBUG`)
+- The app must actually load (no black screen) for it to appear
+- Safari → Settings → Advanced → Show features for web developers
+
+### Android not connecting
+
+```bash
+adb devices  # check connection
+adb disconnect
+adb connect <ip>:5555
+```
+
+## Gossip Bot (optional)
+
+For remote control — send instructions from your phone via Gossip:
+
+```bash
+cd bot.local && npm start
+```
+
+Then set up a cron in Claude Code:
+
+```
+/loop 1m Check bot.local/inbox.jsonl for unprocessed messages...
+```
+
+Bot config is in `bot.local/.env`. See `memory/dev-setup.md` for full details.
@@ -324,6 +324,86 @@ The app uses these Capacitor plugins:
 2. Clear derived data
 3. Reinstall pods: `cd ios/App && pod deintegrate && pod install`
 
+## Wireless Dev Mode
+
+Hot reload directly on your phone over Wi-Fi. Edit code on your Mac, see changes instantly on the device — no cable needed.
+
+### Android
+
+**One-time setup** — connect ADB over Wi-Fi:
+
+```bash
+# With USB plugged in:
+adb tcpip 5555
+adb connect <phone-ip>:5555
+# Unplug USB. Verify:
+adb devices
+```
+
+**Run:**
+
+```bash
+npm run cap:dev:android -- <device>
+# Example: npm run cap:dev:android -- 10.26.239.15:5555
+```
+
+### iOS
+
+**One-time setup** — enable Wi-Fi debugging in Xcode:
+
+1. Connect iPhone via USB
+2. Xcode → Window → Devices and Simulators → check "Connect via network"
+3. Unplug — device stays visible wirelessly
+
+**Run:**
+
+```bash
+# List available devices
+npm run cap:list:ios
+
+# Run with a specific device
+npm run cap:dev:ios -- "iPhone de Ben"
+
+# Without target — opens Xcode, pick your device
+npm run cap:dev:ios
+```
+
+### How it works
+
+Both scripts:
+
+1. Detect your Mac's local IP
+2. Build the SDK
+3. Set `DEV_SERVER_URL` so the Capacitor WebView points at the Vite dev server
+4. Sync and deploy the app to your device
+5. Start Vite with `--host` (HTTPS via mkcert for `crypto.subtle` support)
+
+Self-signed certs are accepted in debug builds only:
+
+- **Android**: `BridgeWebViewClient` override in `MainActivity.java`
+- **iOS**: `WKNavigationDelegate` override in `MyViewController.swift` (`#if DEBUG`)
+
+### Troubleshooting
+
+- **Android "cannot find symbol BuildConfig"**: Ensure `buildFeatures { buildConfig = true }` in `android/app/build.gradle`
+- **iOS cert rejected**: Make sure you're running a Debug build, not Release
+- **Device not found**: Check `adb devices` (Android) or `npx cap run ios --list` (iOS)
+- **Hot reload not working**: Verify phone and Mac are on the same Wi-Fi network
+
+### All Capacitor Commands
+
+| Command                    | Description                                  |
+| -------------------------- | -------------------------------------------- |
+| `npm run cap:dev:android`  | Live reload on Android device over Wi-Fi     |
+| `npm run cap:dev:ios`      | Live reload on iOS device over Wi-Fi         |
+| `npm run cap:sync:android` | Build web assets and sync to Android project |
+| `npm run cap:sync:ios`     | Build web assets and sync to iOS project     |
+| `npm run cap:run:android`  | Build, sync, and run on Android device       |
+| `npm run cap:run:ios`      | Build, sync, and run on iOS simulator        |
+| `npm run cap:open:android` | Open Android project in Android Studio       |
+| `npm run cap:open:ios`     | Open iOS project in Xcode                    |
+| `npm run cap:list:ios`     | List available iOS devices                   |
+
 ## Contributing
 
 1. Fork the repository