chore: add Dockerfile and Space README

.dockerignore

@@ -0,0 +1,11 @@
+node_modules
+build
+.svelte-kit
+.data
+.data-*
+.env
+.env.*
+test-results
+playwright-report
+docs
+tests

Dockerfile

@@ -0,0 +1,20 @@
+FROM node:22-slim AS build
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci
+COPY . .
+RUN npm run build && npm prune --omit=dev
+
+FROM node:22-slim
+WORKDIR /app
+ENV NODE_ENV=production \
+    PORT=7860 \
+    HOST=0.0.0.0 \
+    STORAGE=hf \
+    BODY_SIZE_LIMIT=8M
+COPY --from=build /app/build ./build
+COPY --from=build /app/node_modules ./node_modules
+COPY --from=build /app/package.json ./package.json
+EXPOSE 7860
+USER node
+CMD ["node", "build"]

README.md

@@ -1,10 +1,53 @@
 ---
 title: Splitwise
-emoji: 🐨
+emoji: 💸
 colorFrom: green
-colorTo: gray
+colorTo: blue
 sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Splitwise-style expense splitter
+
+Shared expenses for a small group of friends: equal / percent / exact splits, receipt photos,
+balances with simplified debts, settlements, and an admin who manages users.
+
+Data lives in a private Hugging Face Storage Bucket as an append-only event log
+(`events/*.json` → hourly compaction into `ledger.jsonl`) plus `users.json`. There is no
+database. See `docs/superpowers/specs/2026-08-29-splitwise-clone-design.md`.
+
+## Space configuration
+
+Set these in the Space **Settings → Variables and secrets**:
+
+| Name | Kind | Value |
+|---|---|---|
+| `HF_TOKEN` | secret | fine-grained token with **write** access to the bucket below |
+| `HF_BUCKET` | variable | `buckets/assafvayner/splitwise-data` |
+| `HF_PREFIX` | variable | directory inside the bucket for this deployment, e.g. `prod` (integration tests use `test/<id>/`); empty = bucket root |
+| `SESSION_SECRET` | secret | `openssl rand -base64 32` |
+| `ORIGIN` | variable | the public URL of the Space, e.g. `https://assafvayner-splitwise.hf.space` (required for form submissions) |
+| `CURRENCY` | variable | ISO code, default `USD` |
+| `COMPACTION_INTERVAL_MS` | variable | default `3600000` (1 hour) |
+
+First boot creates the `admin` user with password `1234`; the first admin login forces a password change.
+Then create your friends' accounts on `/admin`.
+
+## Local development
+
+```bash
+cp .env.example .env      # STORAGE=local writes to .data/
+npm install
+npm run dev
+```
+
+`npm test` runs unit tests; `npm run test:e2e` runs the Playwright smoke test against a production build;
+`npm run test:integration` runs the real-bucket tests under a throwaway `test/<id>/` prefix (needs `HF_TOKEN`/`HF_BUCKET` in `.env`; skipped otherwise).
+
+## Deploy
+
+```bash
+git remote add space https://huggingface.co/spaces/assafvayner/splitwise
+git push space main
+```