Docker Compose for Dev Environments

version: "3.8"
services:
  api:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://app:secret@db:5432/myapp
      - REDIS_URL=redis://cache:6379
    volumes:
      - ./src:/app/src
    depends_on:
      db:
        condition: service_healthy
      cache:
        condition: service_started

  db:
    image: postgres:16
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: myapp
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app"]
      interval: 5s
      timeout: 5s
      retries: 5

  cache:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  pgdata:

services:
  api:
    build: .
    volumes:
      - ./src:/app/src
      - /app/node_modules  # Prevent overwriting container's node_modules
    command: npm run dev

# init.sql — runs on first container start
CREATE TABLE IF NOT EXISTS users (
  id SERIAL PRIMARY KEY,
  email VARCHAR(255) UNIQUE NOT NULL,
  name VARCHAR(255)
);

INSERT INTO users (email, name) VALUES
  ('alice@example.com', 'Alice'),
  ('bob@example.com', 'Bob');

docker compose down -v  # -v removes volumes
docker compose up -d

# docker-compose.override.yml (auto-loaded)
services:
  api:
    command: npm run dev
    environment:
      - DEBUG=true
      - LOG_LEVEL=debug

docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

# Start everything
docker compose up -d

# View logs
docker compose logs -f api

# Run a one-off command
docker compose exec api npm run migrate

# Rebuild after Dockerfile changes
docker compose up -d --build

# Stop and clean up
docker compose down

# Nuclear option — remove everything including volumes
docker compose down -v --rmi all

services:
  api:
    build: .
    ports:
      - "3000:3000"

  mailhog:
    image: mailhog/mailhog
    ports:
      - "8025:8025"
    profiles:
      - email

  adminer:
    image: adminer
    ports:
      - "8080:8080"
    profiles:
      - debug

# Normal dev
docker compose up -d

# With email testing
docker compose --profile email up -d

# With everything
docker compose --profile email --profile debug up -d