Mythogeo

Free-form mythogeography for Android: trace your walks, mark spots, attach notes and media. Local-first; public posting comes later.

One-time setup (human, ~30 min, mostly waiting)

You need: a free Expo account, Node 20+, and your phone.

npm ci                        # installs eas-cli too — run this first
npx eas login                 # or set EXPO_TOKEN
npx eas init                  # links the project, writes the projectId into app.json
npx eas build --profile development --platform android

The eas command comes from the eas-cli devDependency, so npm ci must run before any npx eas .... (Never npm install eas — that is an unrelated squatted package.)

The build runs in Expo's cloud (~15 min). When it finishes, open the build link on your phone and install the APK.

For agent-driven development, create an access token at expo.dev → Account settings → Access tokens, and provide it to the agent environment as EXPO_TOKEN. Also add it as a GitHub Actions secret if you want CI publishing.

Daily loop

• Agent edits code → runs npm run verify (typecheck, lint, and the full test suite — unit tests plus in-process e2e journeys through the real screen and a real SQLite db, see e2e/README.md) → npm run publish:ota "message"
• You: force-close and reopen Mythogeo. It downloads the update on launch.
• Walk around. Report what you see.

If the agent tells you it made a native change, wait for the new build link and reinstall the APK instead.

First field test checklist

1. Open the app → grant location "While using the app"
2. Tap Start trace → grant "Allow all the time" in the settings screen that opens
3. Pocket the phone, walk a block or two
4. Reopen: your path should be an amber line
5. Long-press somewhere → save a spot with a note → violet dot appears
6. Tap Stop trace

If the trace has gaps, battery optimization may be throttling the app: Settings → Apps → Mythogeo → Battery → Unrestricted.