feat(mobile): Flutter iOS app v0.1

.github/workflows/ci-mobile.yml

@@ -0,0 +1,95 @@
+name: ci-mobile
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'mobile/**'
+      - 'packages/ferrostar_flutter/**'
+  pull_request:
+    paths:
+      - 'mobile/**'
+      - 'packages/ferrostar_flutter/**'
+
+jobs:
+  test-mobile:
+    name: Flutter tests (iOS)
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: 'stable'
+          cache: true
+
+      - name: Install dependencies (plugin)
+        working-directory: packages/ferrostar_flutter
+        run: flutter pub get
+
+      - name: Install dependencies (app)
+        working-directory: mobile
+        run: flutter pub get
+
+      - name: Analyze (plugin)
+        working-directory: packages/ferrostar_flutter
+        run: flutter analyze
+
+      - name: Analyze (app)
+        working-directory: mobile
+        run: flutter analyze
+
+      - name: Test (plugin)
+        working-directory: packages/ferrostar_flutter
+        run: flutter test
+
+      - name: Test (app)
+        working-directory: mobile
+        run: flutter test
+
+  test-mobile-ios:
+    name: Flutter integration tests (iOS simulator)
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: flutter-actions/setup-flutter@v3
+        with:
+          channel: stable
+
+      - name: Install dependencies (plugin)
+        working-directory: packages/ferrostar_flutter
+        run: flutter pub get
+
+      - name: Install dependencies (app)
+        working-directory: mobile
+        run: flutter pub get
+
+      - name: Boot iPhone 17 simulator
+        run: |
+          UDID=$(xcrun simctl list devices available --json \
+            | python3 -c "
+          import json,sys
+          devs = json.load(sys.stdin)['devices']
+          for runtime, devices in devs.items():
+            for d in devices:
+              if 'iPhone 17' in d['name'] and d['isAvailable']:
+                print(d['udid']); exit()
+          ")
+          xcrun simctl boot "$UDID"
+          echo "SIM_UDID=$UDID" >> "$GITHUB_ENV"
+
+      - name: Enable Flutter SPM integration
+        working-directory: mobile
+        run: flutter config --enable-swift-package-manager
+
+      - name: Build (simulator, no codesign)
+        working-directory: mobile
+        run: flutter build ios --no-codesign --simulator
+
+      - name: Run integration smoke test
+        working-directory: mobile
+        run: flutter test integration_test/navigation_smoke_test.dart -d "$SIM_UDID"

.github/workflows/ci.yml

@@ -70,13 +70,18 @@ jobs:
         with:
           node-version: 22
           cache: npm
-          cache-dependency-path: frontend/package-lock.json
+          cache-dependency-path: web/package-lock.json
 
       - run: npm ci
-        working-directory: frontend
+        working-directory: web
 
       - run: npm run build
-        working-directory: frontend
+        working-directory: web
+
+      - name: regenerate mobile style and verify it matches committed artifact
+        run: |
+          npm --prefix web run build:mobile-style
+          git diff --exit-code mobile/assets/styles/beebeebike-style.json
 
   publish:
     needs: [lint, test-backend, test-frontend]

.gitignore

@@ -55,3 +55,13 @@ data/tiles/
 
 # ── GSD baseline (auto-generated) ──
 vendor/
+
+# Flutter
+**/.dart_tool/
+**/.flutter-plugins
+**/.flutter-plugins-dependencies
+**/.packages
+**/flutter_export_environment.sh
+**/Pods/
+**/.symlinks/
+mobile/ios/Runner.xcworkspace/xcshareddata/swiftpm/

CLAUDE.md

@@ -39,15 +39,44 @@ cargo clippy -- -D warnings
 
 Backend uses `SQLX_OFFLINE=true` for Docker builds (no live DB needed at compile time). Locally, sqlx connects to Postgres at build time for query checking.
 
-### Frontend only
+### Web app (Svelte)
 
 ```bash
-cd frontend
+cd web
 npm ci
 npm run dev        # Vite dev server on :5173, proxies /api → localhost:3000
-npm run build      # production build → frontend/dist/
+npm run build      # production build → web/dist/
 ```
 
+### Mobile app (iOS only)
+
+```bash
+cd mobile
+flutter pub get
+flutter test
+
+# Run on iOS simulator (defaults point to docker dev stack:
+#   api 127.0.0.1:3000, tile server 127.0.0.1:8080)
+flutter run -d ios
+
+# Override for non-default environments:
+flutter run -d ios \
+  --dart-define=BEEBEEBIKE_API_BASE_URL=http://other-host:3000 \
+  --dart-define=BEEBEEBIKE_TILE_SERVER_BASE_URL=http://other-host:8080
+```
+
+Platform scope: iOS only in v0.1. `ferrostar_flutter` (at `packages/ferrostar_flutter/`) is a path dependency and must be present.
+
+### Map style (web + mobile)
+
+The bicycle-planning visual style lives in [web/src/lib/bicycle-style.js](web/src/lib/bicycle-style.js) as `buildBicycleStyle`. It wraps [`@versatiles/style`](https://github.com/versatiles-org/versatiles-style)'s `colorful` style with a custom palette and adds an extra set of bike-priority layers. Both web (at runtime) and mobile (at build time) call the same function. Mobile bundles a pre-baked artifact at `mobile/assets/styles/beebeebike-style.json` whose URLs use the `{{TILE_BASE}}` placeholder, swapped at runtime for `AppConfig.tileServerBaseUrl`. After editing the shared builder, regenerate the mobile artifact:
+
+```bash
+npm --prefix web run build:mobile-style
+```
+
+CI fails if the committed mobile artifact diverges from what the script produces.
+
 ### Static data (not in repo)
 
 OSM extract and vector tiles must be downloaded before first run:
@@ -97,7 +126,7 @@ Rating values are discrete: -7, -3, -1, 0 (eraser), 1, 3, 7. The paint endpoint
 | db | 5432 | PostGIS (spatial queries for rated areas) |
 | graphhopper | 8989 | Bicycle routing with custom model support |
 | tiles | 8080 | VersaTiles vector tile server |
-| frontend (dev only) | 5173 (default) | Vite dev server with API proxy |
+| web (dev only) | 5173 (default) | Vite dev server with API proxy |
 
 ### Migrations
 

README.md

@@ -26,6 +26,20 @@ Then open the app at `http://localhost:5173`.
 
 Docker Compose files live at the project root and are meant to be run from there.
 
+## Mobile app (iOS)
+
+Flutter client in `mobile/`. Requires the `ferrostar_flutter` plugin at `packages/ferrostar_flutter/`.
+
+```bash
+cd mobile
+flutter pub get
+flutter run -d ios \
+  --dart-define=BEEBEEBIKE_API_BASE_URL=http://127.0.0.1:3000 \
+  --dart-define=BEEBEEBIKE_TILE_STYLE_URL=http://127.0.0.1:8080/tiles/assets/styles/colorful/style.json
+```
+
+> Android support is planned for a future release.
+
 ## Contributing
 
 Contributions are welcome. Please open an issue first so we can talk through the idea, the shape of the change, and any bike-brain edge cases before you start building.

backend/Dockerfile

@@ -1,10 +1,10 @@
 # syntax=docker/dockerfile:1.7
 
-FROM node:22-bookworm AS frontend-builder
-WORKDIR /app/frontend
-COPY frontend/package.json frontend/package-lock.json ./
+FROM node:22-bookworm AS web-builder
+WORKDIR /app/web
+COPY web/package.json web/package-lock.json ./
 RUN --mount=type=cache,target=/root/.npm npm ci
-COPY frontend ./
+COPY web ./
 ARG VITE_FATHOM_URL
 RUN npm run build
 
@@ -24,6 +24,6 @@ FROM debian:bookworm-slim
 WORKDIR /app
 RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
 COPY --from=backend-builder /usr/local/bin/beebeebike-backend /usr/local/bin/
-COPY --from=frontend-builder /app/frontend/dist /app/frontend/dist
-ENV STATIC_DIR=/app/frontend/dist
+COPY --from=web-builder /app/web/dist /app/web/dist
+ENV STATIC_DIR=/app/web/dist
 CMD ["beebeebike-backend"]

backend/src/config.rs

@@ -22,7 +22,7 @@ impl Config {
             photon_url: env::var("PHOTON_URL")
                 .unwrap_or_else(|_| "https://photon.komoot.io".into()),
             listen_addr: env::var("LISTEN_ADDR").unwrap_or_else(|_| "0.0.0.0:3000".into()),
-            static_dir: env::var("STATIC_DIR").unwrap_or_else(|_| "../frontend/dist".into()),
+            static_dir: env::var("STATIC_DIR").unwrap_or_else(|_| "../web/dist".into()),
             rating_weight: env::var("RATING_WEIGHT")
                 .ok()
                 .and_then(|v| v.parse().ok())

compose.dev.yml

@@ -1,7 +1,7 @@
 services:
-  frontend:
+  web:
     image: node:22-bookworm
-    working_dir: /workspace/frontend
+    working_dir: /workspace/web
     command: ["sh", "-c", "npm ci && npm run dev -- --host 0.0.0.0"]
     environment:
       VITE_API_PROXY_TARGET: http://backend:3000
@@ -11,9 +11,9 @@ services:
       - "${VITE_DEV_PORT:-5173}:${VITE_DEV_PORT:-5173}"
     volumes:
       - .:/workspace
-      - frontend_node_modules:/workspace/frontend/node_modules
+      - web_node_modules:/workspace/web/node_modules
     depends_on:
       - backend
 
 volumes:
-  frontend_node_modules:
+  web_node_modules:

compose.prod.yml

@@ -51,7 +51,7 @@ services:
       GRAPHHOPPER_URL: http://graphhopper:8989
       PHOTON_URL: https://photon.komoot.io
       LISTEN_ADDR: 0.0.0.0:3000
-      STATIC_DIR: /app/frontend/dist
+      STATIC_DIR: /app/web/dist
     depends_on:
       - db
       - graphhopper

compose.yml

@@ -53,7 +53,7 @@ services:
       GRAPHHOPPER_URL: http://graphhopper:8989
       PHOTON_URL: https://photon.komoot.io
       LISTEN_ADDR: 0.0.0.0:3000
-      STATIC_DIR: /app/frontend/dist
+      STATIC_DIR: /app/web/dist
     depends_on:
       - db
       - graphhopper