# Fullstack Starter Pack - Example Environment Configuration

# This file provides example environment variables for the full-stack application.
# Copy this file to .env (or .env.production, .env.development as needed) and
# fill in the values according to your setup.

# ==============================================================================
# General Application Configuration
# ==============================================================================

NODE_ENV=development # Set to 'production' for production environments

# Application Port (frontend and backend)
PORT=3000 # Frontend port (e.g., React app)
BACKEND_PORT=8000 # Backend port (e.g., Express/FastAPI server)

# API Base URL (Used by frontend to connect to backend)
REACT_APP_API_BASE_URL=http://localhost:8000 # Adjust for production deployment

# ==============================================================================
# Database Configuration (PostgreSQL)
# ==============================================================================

# Database Host (e.g., localhost, IP address, or Docker service name)
DB_HOST=localhost

# Database Port
DB_PORT=5432

# Database Name
DB_NAME=your_database_name

# Database User
DB_USER=your_database_user

# Database Password
DB_PASSWORD=your_database_password

# Enable SSL for database connection (recommended for production)
DB_SSL=false # Set to 'true' for SSL enabled connections.  Requires SSL certificates.

# ==============================================================================
# Backend Configuration (Express/FastAPI)
# ==============================================================================

# Session Secret (Used for session management - MUST be a strong, random string)
SESSION_SECRET=your_super_secret_session_key

# JWT Secret (Used for JWT authentication - MUST be a strong, random string)
JWT_SECRET=your_super_secret_jwt_key

# CORS Configuration (Comma-separated list of allowed origins)
CORS_ORIGIN=http://localhost:3000 # Add your frontend URL(s) here.  Use '*' for all origins (NOT recommended for production).

# ==============================================================================
# AI Agent Configuration (Optional - if using AI features)
# ==============================================================================

# OpenAI API Key (Required if using OpenAI models)
OPENAI_API_KEY=your_openai_api_key

# Other AI Provider API Keys (e.g., Cohere, Anthropic) - Add as needed
# COHERE_API_KEY=your_cohere_api_key
# ANTHROPIC_API_KEY=your_anthropic_api_key

# ==============================================================================
# Logging Configuration (Optional)
# ==============================================================================

# Log Level (e.g., 'debug', 'info', 'warn', 'error')
LOG_LEVEL=info

# ==============================================================================
# Email Configuration (Optional - if using email features)
# ==============================================================================

# Email Service (e.g., 'nodemailer', 'sendgrid')
EMAIL_SERVICE=nodemailer

# Email Host (e.g., SMTP server address)
EMAIL_HOST=smtp.example.com

# Email Port
EMAIL_PORT=587

# Email User
EMAIL_USER=your_email@example.com

# Email Password
EMAIL_PASSWORD=your_email_password

# Email From Address (The address emails will be sent from)
EMAIL_FROM=your_email@example.com

# ==============================================================================
# Deployment Configuration (Optional)
# ==============================================================================

# Base URL for the application (e.g., https://yourdomain.com)
BASE_URL=http://localhost:3000 # Change to your production URL.