From f0643645b8f515ed66bc84221c452c0cccb12454 Mon Sep 17 00:00:00 2001
From: David Folch Agulles <contacto@davidfolch.com>
Date: Wed, 26 Nov 2025 18:57:24 +0100
Subject: [PATCH] Add docker-compose.dev for local development

---
 .gitignore                     |  1 +
 README.md                      | 12 +++++++++++-
 docker-compose.dev.example.yml | 15 +++++++++++++++
 3 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 docker-compose.dev.example.yml

diff --git a/.gitignore b/.gitignore
index deab4a5..a6549a2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,3 +7,4 @@ apocapoc-api
 dist/
 bin/
 .internal-notes/
+docker-compose.dev.yml
diff --git a/README.md b/README.md
index 9ef0a1e..faaa2e0 100644
--- a/README.md
+++ b/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
diff --git a/docker-compose.dev.example.yml b/docker-compose.dev.example.yml
new file mode 100644
index 0000000..f94d8f2
--- /dev/null
+++ b/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