env.local.example

# Copy this file to .env.local and fill in your actual values.
# NEVER commit your .env.local file to version control.

# The absolute URL of your deployment (e.g., http://localhost:3000)
# Required for generating full URLs like OG images and API redirects.
NEXT_PUBLIC_SITE_URL=http://localhost:3000

# MongoDB Connection URI for storing sessions and analytics.
# Get yours from MongoDB Atlas (e.g., mongodb+srv://<user>:<pass>@cluster...)
MONGODB_URI=mongodb+srv://<username>:<password>@cluster0.mongodb.net/commitpulse?retryWrites=true&w=majority

# GitHub Personal Access Token to avoid strict public GraphQL limits.
# Generate at: https://github.com/settings/tokens (No scopes required)
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Vercel KV / Upstash Redis URL for distributed rate limiting.
# Leave blank to operate with degraded local-memory rate limits.
KV_REST_API_URL=

# Vercel KV / Upstash Redis API token for authentication.
# Leave blank to operate with degraded local-memory rate limits.
KV_REST_API_TOKEN=

# Maximum background dashboard force-refreshes allowed per user per hour.
# Defaults to 5 if left blank.
MAX_REFRESHES_PER_HOUR=5

# Comma-separated list of trusted proxy IPs (e.g., Cloudflare, Nginx).
# Required to correctly identify client IPs behind reverse proxies.
TRUSTED_PROXIES=

# Set to "true" to automatically trust private IPs (10.x, 192.168.x).
# Defaults to "false" (automatically enabled in development).
TRUST_PRIVATE_PROXIES=false