Add docker-compose.dev for local development

.gitignore

@@ -7,3 +7,4 @@ apocapoc-api
 dist/
 bin/
 .internal-notes/
+docker-compose.dev.yml

README.md

@@ -69,8 +69,18 @@ The API will be available at `http://localhost:8080`
 
 - Go 1.23+
 - SQLite
+- Docker (optional)
 
-### Running locally
+### Running locally with Docker (Recommended)
+
+```bash
+cp docker-compose.dev.example.yml docker-compose.dev.yml
+docker-compose -f docker-compose.dev.yml up --build
+```
+
+The API will be available at `http://localhost:8080`
+
+### Running locally with Go
 
 ```bash
 cp .env.example .env

docker-compose.dev.example.yml

@@ -0,0 +1,15 @@
+services:
+  api:
+    build: .
+    ports:
+      - "8080:8080"
+    environment:
+      - DB_PATH=/data/apocapoc.db
+      - JWT_SECRET=dev-secret-key-change-in-production
+      - JWT_EXPIRY=24h
+      - REFRESH_TOKEN_EXPIRY=168h
+      - CORS_ORIGINS=*
+      - DEFAULT_TIMEZONE=UTC
+    volumes:
+      - ./data:/data
+    restart: unless-stopped