.env.example

# ============================================================================
# GRANTFLOW ENVIRONMENT CONFIGURATION
# ============================================================================
# Copy this file to .env and fill in the values:
#   cp .env.example .env
#
# The DATABASE_URL below matches the Docker Compose configuration.
# If you're using Docker (pnpm db:setup), these values work out of the box.
# ============================================================================

# ----------------------------------------------------------------------------
# Database (required)
# ----------------------------------------------------------------------------
# Docker Compose defaults (ready to use):
DATABASE_URL=postgresql://postgres:postgres@localhost:5433/grantflow

# NOTE: Port 5433 is used to avoid conflicts with local PostgreSQL instances.
# The docker-compose.yml maps external port 5433 to internal port 5432.

# ----------------------------------------------------------------------------
# Authentication (required)
# ----------------------------------------------------------------------------
# Used internally by Auth.js v5 to sign session tokens and cookies.
# Generate with: openssl rand -base64 32
AUTH_SECRET=your-secret-key-here-generate-with-openssl

# The URL where your app is running (used by Auth.js for OAuth callbacks).
NEXTAUTH_URL=http://localhost:3000

# ----------------------------------------------------------------------------
# GitHub OAuth (required for GitHub login)
# ----------------------------------------------------------------------------
# Create a GitHub OAuth App at: https://github.com/settings/developers
# Set the callback URL to: http://localhost:3000/api/auth/callback/github
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret

# ----------------------------------------------------------------------------
# Optional: GitHub API Access
# ----------------------------------------------------------------------------
# Used for fetching repository data (commits, milestones, etc.)
# Create a personal access token at: https://github.com/settings/tokens
# Required scopes: repo (read)
# GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx
# NEXT_PUBLIC_GITHUB_TOKEN=ghp_xxxxxxxxxxxx

# ----------------------------------------------------------------------------
# Optional: Email (for magic link authentication)
# ----------------------------------------------------------------------------
# Sign up at https://resend.com and create an API key.
# Without this, only GitHub OAuth login is available.
# RESEND_API_KEY=re_xxxxxxxxxxxx
# EMAIL_FROM=noreply@grantflow.dev

# ----------------------------------------------------------------------------
# Optional: AI/LLM Features
# ----------------------------------------------------------------------------
# Used for grant analysis and AI-assisted features.
# Get a key from the Akash Chat API.
# AKASH_CHATAPI_KEY=your-akash-api-key

# ----------------------------------------------------------------------------
# Optional: Polkadot Multisig Configuration (seed data overrides)
# ----------------------------------------------------------------------------
# These override the default test addresses used when seeding the database.
# If not set, the seed script uses hardcoded Paseo testnet defaults.
# You only need to set these if you're testing with a different bounty/multisig.
#
# PARENT_BOUNTY_ID=31
# CURATOR_PROXY_ADDRESS=15jgfpfSvcEF7FXd77LZ8eBh4MVeSfK5DbWJ6mQsonwvi7ZY
# MULTISIG_ADDRESS=16UkJk6ZuA6CdmT9YiyjnpNpgRUVh9fMGtkfmi8HCFSe6aqM
# SIGNATORY_1_ADDRESS=5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY
# SIGNATORY_2_ADDRESS=5FLSigC9HGRKVhB9FiEo4Y3koPsNmBmLJbpXg2mp1hXcS59Y