ci: docker compose for easy access

README.md

@@ -159,6 +159,25 @@ bun run dev
 - Web: `http://localhost:5173`
 - API: `http://localhost:3000`
 
+## Docker Compose Deployment
+
+Run the full stack with PostgreSQL, database initialization, API, and web UI:
+
+```bash
+cp .env.example .env
+docker compose up -d
+```
+
+Default endpoints:
+
+- Web: `http://localhost:3001`
+- API: `http://localhost:3000`
+
+On first startup, the database initializer applies the schema and seeds the sample admin only when the users table is empty.
+
+Docker Compose reads the root `.env` file automatically. Edit it before startup if you need different ports, public URLs, credentials, or secrets.
+
+
 ## Project Structure
 
 ```text
@@ -186,5 +205,5 @@ See:
 ## Notes
 
 - DNS checking is limited to A record / IPv4 as required.
-- This is not a deployment platform and does not include SSH, Docker orchestration, or reverse proxy automation.
+- Docker Compose is available for running the app stack; the app itself does not include SSH, reverse proxy, or host orchestration automation.
 - Full workspace typecheck is still blocked by a pre-existing desktop typing issue for `three`, but the web app and server app are verified.