.env.example

# =====================================================
# SmartWatt Frontend - Environment Configuration
# =====================================================
# 
# Instructions:
# 1. Copy this file to .env.local for local development
# 2. Copy this file to .env.production for production builds
# 3. Fill in your actual values
# 4. Never commit .env.local or .env.production to git
#
# Note: Variables prefixed with NEXT_PUBLIC_ are exposed 
# to the browser. Never put sensitive data in them!
#
# =====================================================

# ============================
# Required Variables
# ============================

# Backend API URL (REQUIRED)
# Local development: http://localhost:8000
# Production: Your deployed backend URL
NEXT_PUBLIC_BACKEND_URL=http://localhost:8000

# ============================
# Database Configuration
# ============================

# Supabase Configuration (Optional - for user data storage)
# Sign up at https://supabase.com to get these credentials
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-public-key-here

# ============================
# Analytics & Monitoring
# ============================

# Google Analytics (Optional)
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX

# Vercel Analytics (Automatically enabled on Vercel)
# No configuration needed

# Sentry Error Tracking (Optional)
# NEXT_PUBLIC_SENTRY_DSN=https://your-sentry-dsn.ingest.sentry.io/123456
# SENTRY_AUTH_TOKEN=your-sentry-auth-token

# ============================
# Feature Flags
# ============================

# Enable/disable features without code changes

# Dark mode toggle (future feature)
NEXT_PUBLIC_ENABLE_DARK_MODE=false

# PDF export functionality
NEXT_PUBLIC_ENABLE_PDF_EXPORT=true

# Social media sharing
NEXT_PUBLIC_ENABLE_SOCIAL_SHARE=true

# User authentication (future feature)
NEXT_PUBLIC_ENABLE_AUTH=false

# Save user preferences
NEXT_PUBLIC_ENABLE_PREFERENCES=true

# Enable appliance recommendations
NEXT_PUBLIC_ENABLE_RECOMMENDATIONS=true

# ============================
# API Configuration
# ============================

# API request timeout (milliseconds)
NEXT_PUBLIC_API_TIMEOUT=30000

# Enable API request caching
NEXT_PUBLIC_ENABLE_API_CACHE=true

# API retry attempts on failure
NEXT_PUBLIC_API_RETRY_COUNT=3

# ============================
# UI Configuration
# ============================

# App name (displayed in header/title)
NEXT_PUBLIC_APP_NAME=SmartWatt

# Default currency symbol
NEXT_PUBLIC_CURRENCY_SYMBOL=₹

# Date format (e.g., MM/DD/YYYY or DD/MM/YYYY)
NEXT_PUBLIC_DATE_FORMAT=DD/MM/YYYY

# Number format locale
NEXT_PUBLIC_LOCALE=en-IN

# ============================
# External Services
# ============================

# Map Service API Key (Optional - for location-based features)
# NEXT_PUBLIC_MAPBOX_TOKEN=your-mapbox-token
# NEXT_PUBLIC_GOOGLE_MAPS_KEY=your-google-maps-key

# Payment Gateway (Future feature)
# NEXT_PUBLIC_RAZORPAY_KEY=your-razorpay-key
# NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your-stripe-key

# ============================
# Development Only
# ============================

# Enable debug logging in browser console
NEXT_PUBLIC_DEBUG=false

# Show development tools
NEXT_PUBLIC_DEV_TOOLS=false

# Mock API responses (for development without backend)
NEXT_PUBLIC_MOCK_API=false

# Enable React Query Devtools
NEXT_PUBLIC_REACT_QUERY_DEVTOOLS=false

# ============================
# Build Configuration
# ============================

# Environment (development | staging | production)
NODE_ENV=development

# Disable telemetry (Next.js usage data)
NEXT_TELEMETRY_DISABLED=1

# ============================
# Server-Side Only Variables
# ============================
# These are NOT exposed to the browser
# Safe to store sensitive information

# Backend API Key (if required)
# BACKEND_API_KEY=your-secret-api-key

# Supabase Service Role Key (server-side only)
# SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# ============================
# Example Configurations
# ============================

# --- Local Development ---
# NEXT_PUBLIC_BACKEND_URL=http://localhost:8000
# NEXT_PUBLIC_DEBUG=true
# NEXT_PUBLIC_MOCK_API=false

# --- Staging Environment ---
# NEXT_PUBLIC_BACKEND_URL=https://staging-api.smartwatt.com
# NEXT_PUBLIC_DEBUG=true
# NEXT_PUBLIC_GA_ID=G-STAGING123

# --- Production Environment ---
# NEXT_PUBLIC_BACKEND_URL=https://api.smartwatt.com
# NEXT_PUBLIC_DEBUG=false
# NEXT_PUBLIC_GA_ID=G-PROD123456
# NEXT_PUBLIC_ENABLE_PDF_EXPORT=true

# =====================================================
# Notes:
# - All NEXT_PUBLIC_* variables are bundled into the JavaScript sent to browsers
# - Never put passwords, API secrets, or private keys in NEXT_PUBLIC_* variables
# - Variables without NEXT_PUBLIC_ prefix are only available server-side
# - See Next.js documentation: https://nextjs.org/docs/basic-features/environment-variables
# =====================================================