infrastructure: add Docker Compose setup for full local development stack

[ShantKhatri]

Summary

Product doc section 6.4 specifies DevCard must be fully self-hostable via Docker Compose. Create a working docker-compose.yml at the project root that spins up all services: PostgreSQL, Redis, backend, and web.

Context

The monorepo root already has a package.json and pnpm workspace. The backend uses Fastify (apps/backend) and the web app uses SvelteKit (apps/web). The backend references DATABASE_URL and environment variables in apps/backend/src/env.ts.

Tasks

• create docker-compose.yml at the project root with services:
  • db: postgres:15-alpine with POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD env vars, persistent named volume.
  • redis: redis:7-alpine with persistent volume.
  • backend: built from apps/backend/Dockerfile (create Dockerfile if it doesn't exist), depends on db and redis, exposes port 3001.
  • web: built from apps/web/Dockerfile (create if needed), depends on backend, exposes port 5173.
• create apps/backend/Dockerfile using multi-stage build: install deps → compile TypeScript → run production image.
• create apps/web/Dockerfile using Node + SvelteKit adapter-node or adapter-static.
• create .env.example at root with all required env vars and explanatory comments.
• add a docker-compose.override.yml for dev-mode hot-reload mounts.
• update README.md with a Self-Hosting section using the Compose workflow.
• validate by running docker compose up and confirming health check at localhost:3001/health.

Acceptance Criteria

• docker compose up brings up all services without errors.
• backend /health responds 200 from within the compose network.
• web app is reachable at localhost:5173.
• data persists across docker compose down && docker compose up.

Difficulty

senior — requires Docker multi-stage build expertise, service dependency management, volume persistence, and environment variable security practices.

[samyuktaap]

Hi @ShantKhatri 👋
I would like to work on this issue under GSSoC'26.

I have experience with Docker and backend setup configurations, and I would like to implement the Docker Compose-based local development stack for this project.

Please assign this issue to me. Thank you!

[ShantKhatri]

Hi @ShantKhatri 👋 I would like to work on this issue under GSSoC'26.

I have experience with Docker and backend setup configurations, and I would like to implement the Docker Compose-based local development stack for this project.

Please assign this issue to me. Thank you!

Hi @samyuktaap , warm welcome. Assigning.

[Midoriya-w]

Hey @ShantKhatri! I'd love to co-contribute or pick this up if the current assignee doesn't deliver. I have hands-on Docker Compose experience from arachnode (multi-service setup: Redis, FastAPI, Scrapy, PostgreSQL). I can have the full setup ready quickly including multi-stage Dockerfiles, .env.example, and the override file for hot-reload. Happy to start anytime!

[samyuktaap]

U will complete it by tonight

…

On Sun, May 17, 2026, 12:11 AM Prashantkumar Khatri < ***@***.***> wrote: Assigned #37 <#37> to @samyuktaap <https://github.com/samyuktaap>. — Reply to this email directly, view it on GitHub <#37 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BZPVEIZCLGSDG23N6HKBR7L43CY4TAVCNFSM6AAAAACXBWKV5SVHI2DSMVQWIX3LMV45UABCJFZXG5LFIV3GK3TUJZXXI2LGNFRWC5DJN5XDWMRVGYYTGMJSGM2DCMY> . You are receiving this because you were assigned.Message ID: ***@***.***>

[samyuktaap]

@ShantKhatri i have completed my work kindly check on my pr and give feedback
thank you