barebones docker | pocketbase | hono | svelte

AGENTS.md

@@ -9,7 +9,7 @@
 # FamChore v2 — AI Agent Reference
 
 ## Stack
-- SvelteKit (SSR frontend) + Hono proxy (same container, port :3001)
+- SvelteKit (SSR frontend, internal :2080) + Hono proxy (internal :3456) + nginx (container :3001)
 - PocketBase (separate Coolify service at `pb.chores.app.com`, :8090)
 - Stripe one-time donations
 - Coolify CRON → `GET /api/weekly-cron`
@@ -61,9 +61,15 @@
 - Every collection query includes `famId = @request.auth.famId` filter
 - Super admin bypasses famId filter (access via PB admin API)
 - `deviceToken` stored as SHA-256 hash; never log raw tokens
-- Environment: `PB_URL`, `PB_ADMIN_EMAIL`, `PB_ADMIN_PASSWORD`, `STRIPE_SECRET_KEY`, `DONATION_MODAL_INTERVAL`
+- `config.ts` at root for dev/build-time shared config (e.g. `PROXY_PORT`); runtime config via env vars
+- `.env` at root tracks port values (`PROXY_PORT`, `PORT`); `.env.example` committed as template
+- Docker: `docker/Dockerfile` (prod, multi-stage + nginx) + `docker/Dockerfile.dev` (PocketBase)
+- Nginx routes in prod: `/api/*` → Hono (`:3456`), `/*` → SvelteKit (`:2080`)
+- Ports: frontend `2080`, proxy `3456`, container ext `3001` (port `3000` is reserved)
+- Environment: `FRONTEND_PORT`, `PROXY_PORT`, `PB_URL`, `PB_ADMIN_EMAIL`, `PB_ADMIN_PASSWORD`, `STRIPE_SECRET_KEY`, `DONATION_MODAL_INTERVAL`
 - Seed via JSON dump (portable for dev)
-- Monorepo: SvelteKit in `/src`, Hono in `/proxy`, two Dockerfiles
+- Monorepo: SvelteKit in `frontend/`, Hono in `proxy/`, two Dockerfiles
+- Decisions tracked in `MEMORY.md`
 
 ## Build Phases (must validate each before next)