.env.example

# ============================================================================
# GROQTALES ENVIRONMENT VARIABLES
# ============================================================================
# Copy this file to .env.local and fill in your actual values
# Never commit .env.local to version control
# ============================================================================

# ----------------------------------------------------------------------------
# APPLICATION CONFIGURATION
# ----------------------------------------------------------------------------
NEXT_PUBLIC_APP_NAME="GroqTales"
NEXT_PUBLIC_APP_URL=https://groqtales.com
NEXT_PUBLIC_APP_DESCRIPTION="AI-Powered Web3 Storytelling Platform"
NODE_ENV=development

# Required environment variables for the application
NEXT_PUBLIC_URL=http://localhost:3000
NEXT_PUBLIC_ONCHAINKIT_PROJECT_NAME=GroqTales
NEXT_PUBLIC_VERSION=1.0.0
NEXT_PUBLIC_IMAGE_URL=https://groqtales.com/images
NEXT_PUBLIC_SPLASH_IMAGE_URL=https://groqtales.com/splash.jpg
NEXT_PUBLIC_SPLASH_BACKGROUND_COLOR="#1a1a2e"

# ----------------------------------------------------------------------------
# AI/GROQ CONFIGURATION
# ----------------------------------------------------------------------------
# Groq API key for AI story generation
NEXT_PUBLIC_GROQ_API_KEY=your_groq_api_key_here
GROQ_API_URL=https://api.groq.com/openai/v1

# OpenAI API Key (fallback)
NEXT_PUBLIC_OPENAI_API_KEY=your_openai_api_key_here

# Google Imagen API Configuration
NEXT_PUBLIC_GOOGLE_IMAGEN_API_KEY=your_google_imagen_api_key_here

# Stability AI Configuration
NEXT_PUBLIC_STABILITY_AI_API_KEY=your_stability_ai_api_key_here

# ----------------------------------------------------------------------------
# DATABASE CONFIGURATION
# ----------------------------------------------------------------------------
# MongoDB connection string
MONGODB_URI=your_mongodb_uri_here
MONGODB_DB_NAME=your_mongodb_db_name_here

# Database connection retry configuration (Issue #166)
# Maximum number of connection retry attempts
DB_MAX_RETRIES=5
# Initial delay between retries in milliseconds (exponential backoff applies)
DB_RETRY_DELAY_MS=2000

# Redis for caching (optional)
REDIS_URL=redis://localhost:6379
REDIS_PASSWORD=

# ----------------------------------------------------------------------------
# BLOCKCHAIN & WEB3 CONFIGURATION
# ----------------------------------------------------------------------------
# Alchemy API Configuration
NEXT_PUBLIC_ALCHEMY_API_KEY=your_alchemy_api_key_here
NEXT_PUBLIC_ALCHEMY_NFT_API_URL=your_alchemy_nft_api_url_here
NEXT_PUBLIC_ALCHEMY_TOKEN_API_URL=your_alchemy_token_api_url_here

# Base Network Configuration
NEXT_PUBLIC_BASE_RPC_URL=your_base_rpc_url_here
NEXT_PUBLIC_BASE_CHAIN_ID=your_base_chain_id_here

# Monad Network Configuration
MONAD_TEST_RPC_URL=your_monad_rpc_url_here
MONAD_MAIN_RPC_URL=your_monad_rpc_url_here
MINTER_PRIVATE_KEY=your_minter_private_key_here
MONADSCAN_API_KEY=your_monadscan_api_key_here

# Contract addresses
NEXT_PUBLIC_STORY_NFT_CONTRACT=0x...
NEXT_PUBLIC_MARKETPLACE_CONTRACT=0x...

# Wallet Connect (note: correct spelling)
NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_wallet_connect_project_id_here
# DEPRECATED: Typo version - use NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID instead
NEXT_PUBLIC_WALLET_CONECT_PROJECT_ID=your_wallet_connect_project_id_here

# Coinbase Developer Platform Credentials
NEXT_PUBLIC_COINBASE_PROJECT_ID=your_coinbase_project_id_here
NEXT_PUBLIC_COINBASE_API_KEY_ID=your_coinbase_api_key_id_here
NEXT_PUBLIC_COINBASE_SECRET=your_coinbase_secret_here
NEXT_PUBLIC_COINBASE_MAINNET_RPC_ENDPOINT=your_coinbase_mainnet_rpc_endpoint_here
NEXT_PUBLIC_COINBASE_WALLET_API_SECRET=your_coinbase_wallet_api_secret_here

# ----------------------------------------------------------------------------
# IPFS & FILE STORAGE
# ----------------------------------------------------------------------------
# IPFS configuration for NFT metadata storage
NEXT_PUBLIC_INFURA_IPFS_PROJECT_ID=your_project_id_here
NEXT_PUBLIC_INFURA_IPFS_PROJECT_SECRET=your_project_secret_here

# Pinata API Credentials for IPFS Storage
NEXT_PUBLIC_PINATA_API_KEY=your_pinata_api_key_here
PINATA_API_SECRET=your_pinata_api_secret_here
PINATA_JWT=your_pinata_jwt_here

# Storacha Key
NEXT_PUBLIC_STORACHA_KEY=your_storacha_key_here

# Alternative storage providers
AWS_S3_BUCKET=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=

# ----------------------------------------------------------------------------
# EXTERNAL APIS
# ----------------------------------------------------------------------------
# Unsplash for images
NEXT_PUBLIC_UNSPLASH_API_KEY=your_unsplash_api_key_here

# Analytics
NEXT_PUBLIC_GA_ID=
NEXT_PUBLIC_MIXPANEL_ID=
NEXT_PUBLIC_HOTJAR_ID=

# Social media APIs
TWITTER_API_KEY=
TWITTER_API_SECRET=
DISCORD_BOT_TOKEN=

# ----------------------------------------------------------------------------
# AUTHENTICATION & SECURITY
# ----------------------------------------------------------------------------
# NextAuth.js configuration
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_nextauth_secret_here

# JWT secrets
JWT_SECRET=your_jwt_secret_here
JWT_REFRESH_SECRET=your_jwt_refresh_secret_here
JWT_EXPIRES=30h
JWT_REFRESH_EXPIRES=30d

# Encryption keys
ENCRYPTION_KEY=your_encryption_key_here

# Rate limiting
RATE_LIMIT_MAX_REQUESTS=100
RATE_LIMIT_WINDOW_MS=900000

# ----------------------------------------------------------------------------
# EMAIL & NOTIFICATIONS
# ----------------------------------------------------------------------------
# Email service configuration
EMAIL_FROM=noreply@groqtales.com
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASSWORD=your_app_password

# Notification URL
NEXT_PUBLIC_NOTIFICATION_URL=your_notification_url_here

# SendGrid (alternative)
SENDGRID_API_KEY=

# Push notifications
VAPID_PUBLIC_KEY=
VAPID_PRIVATE_KEY=

# ----------------------------------------------------------------------------
# DEVELOPMENT & DEBUGGING
# ----------------------------------------------------------------------------
# Debug flags
DEBUG=false
VERBOSE_LOGGING=false
ENABLE_MOCK_DATA=false

# Set this to true during build to mock or disable database connections
NEXT_PUBLIC_BUILD_MODE=false

# Feature flags
ENABLE_COMMENTS=true
ENABLE_RATINGS=true
ENABLE_SHARING=true
ENABLE_COLLABORATIONS=false
ENABLE_PREMIUM_CONTENT=false

# Build configuration
BUILD_STANDALONE=false
ANALYZE=false

# ----------------------------------------------------------------------------
# PRODUCTION OVERRIDES
# ----------------------------------------------------------------------------
# These will be set by your hosting provider in production
# VERCEL_URL (automatically set by Vercel)
# DATABASE_URL (production database)
# REDIS_URL (production Redis)

# ============================================================================
# SECURITY NOTICE
# ============================================================================
# 1. Never commit .env.local to version control
# 2. Use strong, unique passwords and API keys
# 3. Enable 2FA on all accounts
# 4. Regularly rotate API keys
# 5. Use environment-specific configurations
# ============================================================================