env.example

# Canvas Configuration
CANVAS_CLIENT_ID=
CANVAS_CLIENT_SECRET=
CANVAS_BASE_URL=
CANVAS_REDIRECT_URI=

# Database Configuration
POSTGRES_USER=user
POSTGRES_PASSWORD=password
POSTGRES_DB=thoughtswap
# Port exposed on the host machine for direct database access
POSTGRES_HOST_PORT=5432

# Server (Backend) Configuration
# Port the Node.js server listens on inside the container
SERVER_PORT=3001
# Port exposed on the host machine to access the API
SERVER_HOST_PORT=8000
# Connection string for Prisma.
DATABASE_URL=postgresql://user:password@postgres:5432/thoughtswap

# Client (Frontend) Configuration
# Port the Vite server listens on inside the container
CLIENT_PORT=5173
# Port exposed on the host machine to access the UI
CLIENT_HOST_PORT=5173
# URL of the backend server for API requests (used by Vite proxy)
SERVER_URL=http://server:3001

# Shared Configuration
# URL where the frontend is accessible (used for CORS on the server)
# Should match http://localhost:${CLIENT_HOST_PORT}
FRONTEND_URL=http://localhost:5173

# ---------------------------------------------------------------------------
# Cloud Run / Cloud SQL Deployment
# ---------------------------------------------------------------------------
# These settings are used when deploying to Google Cloud Run with Cloud SQL.
# They are NOT required for local Docker Compose development.
#
# Cloud SQL instance connection name (found in the GCP Console):
#   CLOUD_SQL_INSTANCE=project-id:region:instance-name
#
# DATABASE_URL format for Cloud SQL via Unix socket (used by Prisma on Cloud Run):
#   DATABASE_URL=postgresql://USER:PASSWORD@localhost/DB_NAME?host=/cloudsql/PROJECT_ID:REGION:INSTANCE_NAME
#
# Example:
#   CLOUD_SQL_INSTANCE=thoughtswap:us-east4:thoughtswap-db
#   DATABASE_URL=postgresql://app_user:s3cret@localhost/thoughtswap?host=/cloudsql/thoughtswap:us-east4:thoughtswap-db
#
# Set RUN_MIGRATIONS=true on Cloud Run to auto-apply Prisma migrations on startup:
#   RUN_MIGRATIONS=true