Fork in the Road

Monorepo for a location-aware restaurant picker:

• apps/api: Axum API backed by PostGIS with an OpenStreetMap Overpass cache
• apps/mobile: Compose Multiplatform app for Android and iOS using Ktor

The mobile client keeps its prototype user profile and allergen preferences local while fetching restaurant picks from POST /api/v1/pick.

Local development

Install the pinned command runner and start the containerized API:

mise install
mise exec -- just api-up

PostGIS binds to 127.0.0.1:5433 and the API binds to http://127.0.0.1:3000. See the app-specific READMEs for environment and simulator configuration.

Verify

just check-all

Build Android with mise exec -- just mobile-android. Open apps/mobile/iosApp/iosApp.xcodeproj with Xcode 26.6 for iOS.

Tooling

The workspace pins just through mise, so a global just installation is not required:

mise install
mise exec -- just check-all