docker-compose.yml

# Define the services (containers) that make up your application.
name: codebuilder
services:
  # 1. The Next.js Frontend Service
  frontend:
    # Build the image from the Dockerfile in the current directory.
    build: .
    image: codebuilder-frontend
    container_name: codebuilder-frontend
    # Ensure the frontend starts after the database is ready.
    depends_on:
      - db
    # Restart the container automatically unless it is explicitly stopped.
    restart: unless-stopped
    # Pass the .env file to the container for environment variables.
    env_file:
      - ./.env
    ports:
      # Map port 3000 on the host to port 3000 in the container.
      - "3000:3000"
    networks:
      # Connect this service to our custom network.
      - codebuilder-net

  # 2. The PostgreSQL Database Service
  db:
    # Use the official PostgreSQL 15 image from Docker Hub.
    image: postgres:15-alpine
    container_name: codebuilder-postgres-db
    restart: unless-stopped
    # Pass the .env file, which must contain the DB credentials.
    env_file:
      - ./.env
    volumes:
      # Mount a named volume to persist the database data.
      - postgres-data:/var/lib/postgresql/data
    networks:
      # Connect this service to our custom network.
      - codebuilder-net
    # Exposing the port is crucial for our new workflow health check.
    ports:
      - "5434:5432"

# Define the custom network that our services will share.
networks:
  codebuilder-net:
    # This correctly tells Compose that the network is managed outside its control.
    external: true

# Define the named volumes for persistent data storage.
volumes:
  postgres-data:
    external: true
    name: codebuilder-postgres-data