Revamp MPA interface and remove SPA rollout

Author: seanap

.env.example

@@ -80,4 +80,6 @@ HOME_RADIUS_MILES=8
 
 # Compose/API
 API_PORT=1609
-DOCKER_IMAGE=seanap/chronicle:latest
+# Optional image tag for local builds or pushed registry images.
+# Leave blank to use the compose default image name and build from this repo checkout.
+DOCKER_IMAGE=

.gitignore

@@ -31,11 +31,6 @@ android/captures/
 *.keystore
 *.aab
 
-# SPA workspace artifacts
-chronicle-ui/node_modules/
-chronicle-ui/dist/
-chronicle-ui/coverage/
-
 # Local AI/dev orchestration artifacts
 .codex/
 _bmad*/

Dockerfile

@@ -1,13 +1,3 @@
-FROM node:22-alpine AS ui-builder
-
-WORKDIR /ui
-
-COPY chronicle-ui/package.json chronicle-ui/package-lock.json ./
-RUN npm ci
-
-COPY chronicle-ui/ ./
-RUN npm run build
-
 FROM python:3.12-slim
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
@@ -23,7 +13,6 @@ COPY requirements.txt /app/requirements.txt
 RUN pip install --no-cache-dir -r /app/requirements.txt
 
 COPY . /app
-COPY --from=ui-builder /ui/dist /app/chronicle-ui/dist
 RUN mkdir -p /app/state
 
 CMD ["python", "-m", "chronicle.worker"]

README.md

@@ -7,6 +7,12 @@
 
 Chronicle automatically builds rich Strava activity descriptions by combining data from Strava and your connected stat sources.
 
+## UI Direction
+- The MPA is the product and the active refinement target.
+- Future styling changes should be reviewed in-browser with `A` vs `B` comparisons at `/design-review`.
+- Product direction details: [`docs/UI_DIRECTION.md`](docs/UI_DIRECTION.md)
+- Refinement process and page order: [`docs/MPA_REFINEMENT_ROADMAP.md`](docs/MPA_REFINEMENT_ROADMAP.md)
+
 ## Key Features
 - Auto-processes new activities on a worker heartbeat.
 - Writes description templates back to Strava based on activity profile.
@@ -47,9 +53,11 @@ cp .env.example .env
 
 ### Step 3: Start Chronicle
 ```bash
-docker compose up -d
+docker compose up -d --build
 ```
 
+- Re-run the same command after pulling new code so the latest backend and frontend assets are rebuilt into the image.
+
 ### Step 4: Open the app
 ```bash
 http://localhost:1609
@@ -60,6 +68,7 @@ http://localhost:1609
 - Template Editor (`Build`): http://localhost:1609/editor
 - Source Setup (`Sources`): http://localhost:1609/setup
 - API Control (`Control`): http://localhost:1609/control
+- Design review: `http://localhost:1609/design-review`
 
 ### Step 5: Add your credentials in `Sources`
 - Go to `Sources` and fill in your source keys/tokens.
@@ -71,16 +80,13 @@ http://localhost:1609
 - Android widget APK downloads: [GitHub Releases](https://github.com/seanap/Chronicle/releases)
 - Misery Index report: [`docs/MISERY_INDEX_REPORT.md`](docs/MISERY_INDEX_REPORT.md)
 
-## SPA Scaffold (Story 1.1)
+## Updating a Docker Deploy
 
-A parallel SPA workspace now exists at `chronicle-ui/` (Vite + React + TypeScript + MUI).
+If you already have Chronicle running and want the current MPA product build to show up:
 
-### Run frontend locally
 ```bash
-cd chronicle-ui
-npm install
-npm run dev
+git pull
+docker compose up -d --build
 ```
 
-- Vite proxy defaults to `http://localhost:1609` and can be overridden with `VITE_API_PROXY_TARGET`.
-- Backend endpoints and response contracts remain source-of-truth and unchanged.
+Then hard refresh the browser on `/dashboard` or `/control`.