docs(260329-x2a): complete create-dockerfile-and-dockerignore plan

- Add 260329-x2a-SUMMARY.md with decisions and usage docs
- Update STATE.md quick tasks table with commit reference

.planning/STATE.md

@@ -143,9 +143,10 @@ None yet.
 | 260329-u4z | Deutsche Umlaute in UI-Texten und CLAUDE.md | 2026-03-29 | 2691d99 | [260329-u4z-deutsche-umlaute-in-ui-texten-und-claude](./quick/260329-u4z-deutsche-umlaute-in-ui-texten-und-claude/) |
 | 260329-ua1 | README.md erstellen (English, open-source) | 2026-03-29 | 4d95cb6 | [260329-ua1-readme-md-erstellen-english-open-source-](./quick/260329-ua1-readme-md-erstellen-english-open-source-/) |
 | 260329-uos | Level-Erweiterung für gesamten Tastaturbereich (16 Level) | 2026-03-29 | 3a71799 | [260329-uos-level-erweiterung-f-r-gesamten-tastaturb](./quick/260329-uos-level-erweiterung-f-r-gesamten-tastaturb/) |
+| 260329-x2a | Dockerfile und .dockerignore für containerisiertes Deployment | 2026-03-29 | 3f5fc0f | [260329-x2a-create-dockerfile-and-dockerignore-for-z](./quick/260329-x2a-create-dockerfile-and-dockerignore-for-z/) |
 
 ## Session Continuity
 
-Last session: 2026-03-29T21:04:00.833Z
+Last session: 2026-03-29T21:07:24.282Z
-Stopped at: Completed 05-02-PLAN.md
+Stopped at: Completed quick task 260329-x2a
 Resume file: None

.planning/quick/260329-x2a-create-dockerfile-and-dockerignore-for-z/260329-x2a-SUMMARY.md

@@ -0,0 +1,75 @@
+---
+phase: quick
+plan: 260329-x2a
+subsystem: deployment
+tags: [docker, deployment, containerization]
+dependency_graph:
+  requires: []
+  provides: [docker-image, containerized-deployment]
+  affects: []
+tech_stack:
+  added: [node:22-alpine, Docker multi-stage build]
+  patterns: [multi-stage Docker build, Vite preview server in container]
+key_files:
+  created:
+    - Dockerfile
+    - .dockerignore
+  modified: []
+decisions:
+  - "All deps are devDependencies (vite, typescript etc.) so serve stage uses npm ci without --omit=dev to have vite available for vite preview"
+  - "config.json override via volume mount to dist/config.json (Vite preview serves dist/)"
+  - "vite.config.ts copied into serve stage so vite preview can read host/port config"
+metrics:
+  duration: "<1min"
+  completed: "2026-03-29"
+  tasks: 1
+  files: 2
+---
+
+# Quick Task 260329-x2a: Dockerfile and .dockerignore for Zauberwald
+
+**One-liner:** Multi-stage Docker build (node:22-alpine) with Vite preview server on port 4173 and runtime config.json override via volume mount.
+
+## Tasks Completed
+
+| Task | Name | Commit | Files |
+|------|------|--------|-------|
+| 1 | Create Dockerfile and .dockerignore | 3f5fc0f | Dockerfile, .dockerignore |
+
+## What Was Built
+
+**Dockerfile** — Two-stage build:
+- Stage 1 (`build`): `node:22-alpine`, installs all deps with `npm ci`, copies source, runs `npm run build` (tsc + vite build) producing `dist/`
+- Stage 2 (`serve`): `node:22-alpine`, installs all deps again (needed for `vite preview`), copies `dist/` and `vite.config.ts` from build stage, exposes port 4173, runs `npm run preview`
+
+**.dockerignore** — Excludes `node_modules`, `dist`, `.git`, `.planning`, `*.md`, `.biome`, `.claude`, `.agents` from build context.
+
+## Usage
+
+```bash
+# Build the image
+docker build -t zauberwald .
+
+# Run with config.json mounted from host
+docker run -v /path/to/config.json:/app/dist/config.json:ro -p 4173:4173 zauberwald
+```
+
+The app is then accessible at `http://localhost:4173`.
+
+## Key Decisions
+
+- All project dependencies are `devDependencies` (vite, typescript, etc.). The serve stage must run `npm ci` (without `--omit=dev`) so that `vite` is available for `npm run preview`.
+- `public/config.json` is intentionally NOT excluded from `.dockerignore` — it must be baked into `dist/` during build. At runtime, users can override it by mounting their own `config.json` to `/app/dist/config.json`.
+- `vite.config.ts` is copied into the serve stage because Vite reads it to apply the `host: "0.0.0.0"` and `port: 4173` preview settings.
+
+## Deviations from Plan
+
+None — plan executed exactly as written.
+
+## Self-Check: PASSED
+
+- Dockerfile exists: FOUND
+- .dockerignore exists: FOUND
+- Commit 3f5fc0f exists: FOUND
+- EXPOSE 4173 in Dockerfile: FOUND
+- node_modules in .dockerignore: FOUND