feat: Comprehensive Project Infrastructure and Template System Implementation

.env.example

@@ -1,13 +1,99 @@
-# Clerk Authentication
-NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key_here
-CLERK_SECRET_KEY=your_clerk_secret_key_here
+# Environment Configuration for CodeGuide Starter Kit
 
-# Supabase
-NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url_here
+# ============================================================================
+# Application
+# ============================================================================
+NODE_ENV=development
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+# ============================================================================
+# Authentication - Clerk
+# ============================================================================
+# Get these from: https://dashboard.clerk.com/
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_your_clerk_publishable_key_here
+CLERK_SECRET_KEY=sk_test_your_clerk_secret_key_here
+
+# Sign in/up URLs (optional, defaults to Clerk hosted pages)
+NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
+NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
+
+# ============================================================================
+# Database - Supabase
+# ============================================================================
+# Get these from: https://supabase.com/dashboard
+NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
 NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key_here
+SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key_here
+
+# For local development with Docker PostgreSQL
+DATABASE_URL=postgresql://codeguide:codeguide123@localhost:5432/codeguide
+
+# ============================================================================
+# AI APIs
+# ============================================================================
+# OpenAI API (get from: https://platform.openai.com/)
+OPENAI_API_KEY=sk-your_openai_api_key_here
+
+# Anthropic API (get from: https://console.anthropic.com/)
+ANTHROPIC_API_KEY=sk-ant-your_anthropic_api_key_here
+
+# ============================================================================
+# File Storage - AWS S3 / MinIO
+# ============================================================================
+# For production (AWS S3)
+AWS_ACCESS_KEY_ID=your_aws_access_key
+AWS_SECRET_ACCESS_KEY=your_aws_secret_key
+AWS_REGION=us-east-1
+AWS_S3_BUCKET_NAME=codeguide-files
+
+# For local development (MinIO)
+MINIO_ENDPOINT=http://localhost:9000
+MINIO_ACCESS_KEY=codeguide
+MINIO_SECRET_KEY=codeguide123
+MINIO_BUCKET_NAME=codeguide-local
+
+# ============================================================================
+# Redis (for caching and rate limiting)
+# ============================================================================
+REDIS_URL=redis://localhost:6379
+
+# ============================================================================
+# Email (for notifications)
+# ============================================================================
+# For production (e.g., SendGrid, AWS SES)
+SMTP_HOST=smtp.your-email-provider.com
+SMTP_PORT=587
+SMTP_USER=your_smtp_user
+SMTP_PASSWORD=your_smtp_password
+SMTP_FROM=noreply@yourdomain.com
+
+# For local development (MailHog)
+LOCAL_SMTP_HOST=localhost
+LOCAL_SMTP_PORT=1025
+
+# ============================================================================
+# Security
+# ============================================================================
+# Generate a strong JWT secret: openssl rand -base64 32
+JWT_SECRET=your_jwt_secret_here
+
+# Generate a strong encryption key for sensitive data
+ENCRYPTION_KEY=your_encryption_key_here
+
+# ============================================================================
+# Monitoring & Analytics
+# ============================================================================
+# Optional: Add your monitoring service keys here
+# SENTRY_DSN=your_sentry_dsn
+# MIXPANEL_TOKEN=your_mixpanel_token
+# GOOGLE_ANALYTICS_ID=your_ga_id
 
-# OpenAI API (for Vercel AI SDK)
-OPENAI_API_KEY=your_openai_api_key_here
+# ============================================================================
+# Development
+# ============================================================================
+# Enable debug logging in development
+DEBUG=true
+LOG_LEVEL=debug
 
-# Anthropic API (optional, for Claude models)
-ANTHROPIC_API_KEY=your_anthropic_api_key_here
+# Disable telemetry in development
+NEXT_TELEMETRY_DISABLED=1