feat: docker deployment with compose quickstart

README.md

@@ -1,3 +1,29 @@
 # record-shop
 
-Easily manage a physical collection of music.
+Easily manage a physical collection of music.
+
+Scan barcodes with your phone to catalogue vinyl, CDs and cassettes, pull
+metadata from Discogs, and see what you have (and haven't) ripped into your
+Subsonic-compatible music server (Navidrome, Gonic, Airsonic, LMS, …).
+
+## Quickstart
+
+```bash
+docker compose up -d
+```
+
+Open <http://localhost:3000>, create the admin account, then add your Discogs
+token and (optionally) your Subsonic server details in Settings.
+
+- Data lives in `./data` (SQLite database + cached cover art).
+- Configure via env if you prefer: `PORT`, `DATA_DIR`.
+
+## Development
+
+```bash
+npm install
+npm test          # vitest
+npm run dev:server
+```
+
+Spec: `docs/superpowers/specs/2026-08-29-record-shop-design.md`