feat: new : BETA VERSION -READY FOR TESTING

.env.production

@@ -1,115 +1,183 @@
-# Rename this file to .env once you have filled in the below environment variables!
+# =============================================================================
+# BOLT.DIY PRODUCTION ENVIRONMENT CONFIGURATION
+# =============================================================================
+# Rename this file to .env once you have filled in the required values
+# This file should contain production-ready API keys and configuration
 
-# Get your GROQ API Key here -
-# https://console.groq.com/keys
-# You only need this environment variable set if you want to use Groq models
-GROQ_API_KEY=
+# =============================================================================
+# APPLICATION SETTINGS
+# =============================================================================
 
-# Get your HuggingFace API Key here -
-# https://huggingface.co/settings/tokens
-# You only need this environment variable set if you want to use HuggingFace models
-HuggingFace_API_KEY=
+# Environment mode (must be 'production' for production deployment)
+NODE_ENV=production
 
-# Get your Open AI API Key by following these instructions -
-# https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key
-# You only need this environment variable set if you want to use GPT models
-OPENAI_API_KEY=
+# Application port (defaults to 5173 for development, 3000 for production)
+PORT=3000
+
+# Logging level (warn, error for production)
+VITE_LOG_LEVEL=warn
+
+# Default context window size for local models
+DEFAULT_NUM_CTX=32768
 
-# Get your Anthropic API Key in your account settings -
-# https://console.anthropic.com/settings/keys
-# You only need this environment variable set if you want to use Claude models
+# =============================================================================
+# MAJOR AI PROVIDER API KEYS
+# =============================================================================
+
+# Anthropic Claude - Primary provider
+# Get your API key from: https://console.anthropic.com/
 ANTHROPIC_API_KEY=
 
-# Get your OpenRouter API Key in your account settings -
-# https://openrouter.ai/settings/keys
-# You only need this environment variable set if you want to use OpenRouter models
-OPEN_ROUTER_API_KEY=
+# OpenAI GPT models - Primary provider
+# Get your API key from: https://platform.openai.com/api-keys
+OPENAI_API_KEY=
 
-# Get your Google Generative AI API Key by following these instructions -
-# https://console.cloud.google.com/apis/credentials
-# You only need this environment variable set if you want to use Google Generative AI models
+# Google Gemini - Primary provider
+# Get your API key from: https://makersuite.google.com/app/apikey
 GOOGLE_GENERATIVE_AI_API_KEY=
 
-# You only need this environment variable set if you want to use oLLAMA models
-# DONT USE http://localhost:11434 due to IPV6 issues
-# USE EXAMPLE http://127.0.0.1:11434
-OLLAMA_API_BASE_URL=
+# =============================================================================
+# SPECIALIZED AI PROVIDERS
+# =============================================================================
 
-# You only need this environment variable set if you want to use OpenAI Like models
-OPENAI_LIKE_API_BASE_URL=
+# Groq (Fast inference models)
+# Get your API key from: https://console.groq.com/keys
+GROQ_API_KEY=
+
+# Together AI (Fine-tuned models)
+# Get your API key from: https://api.together.xyz/settings/api-keys
+TOGETHER_API_KEY=
+
+# OpenRouter (Multi-provider routing)
+# Get your API key from: https://openrouter.ai/keys
+OPEN_ROUTER_API_KEY=
 
-# You only need this environment variable set if you want to use Together AI models
-TOGETHER_API_BASE_URL=
+# =============================================================================
+# INTERNATIONAL & SPECIALIZED PROVIDERS
+# =============================================================================
 
-# You only need this environment variable set if you want to use DeepSeek models through their API
+# DeepSeek (Chinese models)
+# Get your API key from: https://platform.deepseek.com/api_keys
 DEEPSEEK_API_KEY=
 
-# Get your OpenAI Like API Key
-OPENAI_LIKE_API_KEY=
+# Moonshot AI / Kimi (Chinese models)
+# Get your API key from: https://platform.moonshot.ai/console/api-keys
+MOONSHOT_API_KEY=
 
-# Get your Together API Key
-TOGETHER_API_KEY=
+# X.AI (Elon Musk's company)
+# Get your API key from: https://console.x.ai/
+XAI_API_KEY=
 
-# You only need this environment variable set if you want to use Hyperbolic models
-HYPERBOLIC_API_KEY=
-HYPERBOLIC_API_BASE_URL=
+# =============================================================================
+# EUROPEAN & ADDITIONAL PROVIDERS
+# =============================================================================
 
-# Get your Mistral API Key by following these instructions -
-# https://console.mistral.ai/api-keys/
-# You only need this environment variable set if you want to use Mistral models
+# Mistral (European models)
+# Get your API key from: https://console.mistral.ai/api-keys/
 MISTRAL_API_KEY=
 
-# Get the Cohere Api key by following these instructions -
-# https://dashboard.cohere.com/api-keys
-# You only need this environment variable set if you want to use Cohere models
+# Cohere (Canadian models)
+# Get your API key from: https://dashboard.cohere.ai/api-keys
 COHERE_API_KEY=
 
-# Get LMStudio Base URL from LM Studio Developer Console
-# Make sure to enable CORS
-# DONT USE http://localhost:1234 due to IPV6 issues
-# Example: http://127.0.0.1:1234
+# Perplexity AI (Search-augmented models)
+# Get your API key from: https://www.perplexity.ai/settings/api
+PERPLEXITY_API_KEY=
+
+# =============================================================================
+# COMMUNITY & OPEN SOURCE PROVIDERS
+# =============================================================================
+
+# Hugging Face (Open source models)
+# Get your API key from: https://huggingface.co/settings/tokens
+HuggingFace_API_KEY=
+
+# Hyperbolic (High-performance inference)
+# Get your API key from: https://app.hyperbolic.xyz/settings
+HYPERBOLIC_API_KEY=
+
+# GitHub Models (GitHub-hosted OpenAI models)
+# Get your Personal Access Token from: https://github.com/settings/tokens
+GITHUB_API_KEY=
+
+# =============================================================================
+# LOCAL MODEL PROVIDERS
+# =============================================================================
+
+# Ollama (Local model server)
+# DON'T USE http://localhost:11434 due to IPv6 issues
+# USE: http://127.0.0.1:11434
+OLLAMA_API_BASE_URL=
+
+# LMStudio (Local model interface)
+# Make sure to enable CORS in LMStudio
 LMSTUDIO_API_BASE_URL=
 
-# Get your xAI API key
-# https://x.ai/api
-# You only need this environment variable set if you want to use xAI models
-XAI_API_KEY=
+# =============================================================================
+# COMPATIBLE API PROVIDERS
+# =============================================================================
 
-# Get your Perplexity API Key here - 
-# https://www.perplexity.ai/settings/api
-# You only need this environment variable set if you want to use Perplexity models
-PERPLEXITY_API_KEY=
+# OpenAI-compatible API (Any provider using OpenAI format)
+OPENAI_LIKE_API_BASE_URL=
+OPENAI_LIKE_API_KEY=
 
-# Get your AWS configuration
-# https://console.aws.amazon.com/iam/home
-AWS_BEDROCK_CONFIG=
+# =============================================================================
+# CLOUD INFRASTRUCTURE PROVIDERS
+# =============================================================================
 
-# Include this environment variable if you want more logging for debugging locally
-VITE_LOG_LEVEL=
-
-# Get your GitHub Personal Access Token here -
-# https://github.com/settings/tokens
-# This token is used for:
-# 1. Importing/cloning GitHub repositories without rate limiting
-# 2. Accessing private repositories
-# 3. Automatic GitHub authentication (no need to manually connect in the UI)
-# 
-# For classic tokens, ensure it has these scopes: repo, read:org, read:user
-# For fine-grained tokens, ensure it has Repository and Organization access
-VITE_GITHUB_ACCESS_TOKEN=
+# AWS Bedrock Configuration (JSON format)
+# Get your credentials from: https://console.aws.amazon.com/iam/home
+# Example: {"region": "us-east-1", "accessKeyId": "yourAccessKeyId", "secretAccessKey": "yourSecretAccessKey"}
+AWS_BEDROCK_CONFIG=
 
-# Specify the type of GitHub token you're using
-# Can be 'classic' or 'fine-grained'
-# Classic tokens are recommended for broader access
-VITE_GITHUB_TOKEN_TYPE=
+# =============================================================================
+# THIRD-PARTY INTEGRATIONS
+# =============================================================================
 
-# Netlify Authentication
+# GitHub Integration
+# Personal Access Token for repository access
+VITE_GITHUB_ACCESS_TOKEN=
+VITE_GITHUB_TOKEN_TYPE=classic
+
+# Supabase Integration
+# Database URL and API keys for Supabase projects
+# IMPORTANT: Use production-ready API keys, not development keys
+# - Project URL: Your production Supabase project URL
+# - Anon Key: Production anon/public key (safe for client-side)
+# - Access Token: Production service role key (keep secure, server-side only)
+VITE_SUPABASE_URL=
+VITE_SUPABASE_ANON_KEY=
+VITE_SUPABASE_ACCESS_TOKEN=
+
+# Vercel Integration
+# Access token for Vercel deployments and project management
+# IMPORTANT: Use production token with appropriate permissions
+VITE_VERCEL_ACCESS_TOKEN=
+
+# Netlify Deployment
 VITE_NETLIFY_ACCESS_TOKEN=
 
-# Example Context Values for qwen2.5-coder:32b
-# 
-# DEFAULT_NUM_CTX=32768 # Consumes 36GB of VRAM
-# DEFAULT_NUM_CTX=24576 # Consumes 32GB of VRAM
-# DEFAULT_NUM_CTX=12288 # Consumes 26GB of VRAM
-# DEFAULT_NUM_CTX=6144 # Consumes 24GB of VRAM
-DEFAULT_NUM_CTX=
+# =============================================================================
+# PRODUCTION CONTEXT WINDOW EXAMPLES
+# =============================================================================
+# Example values for different model configurations:
+#
+# qwen2.5-coder:32b context window sizes:
+# DEFAULT_NUM_CTX=32768  # Consumes ~36GB VRAM
+# DEFAULT_NUM_CTX=24576  # Consumes ~32GB VRAM
+# DEFAULT_NUM_CTX=12288  # Consumes ~26GB VRAM
+# DEFAULT_NUM_CTX=6144   # Consumes ~24GB VRAM
+
+# =============================================================================
+# SETUP INSTRUCTIONS
+# =============================================================================
+# 1. Fill in the API keys for the providers you want to use in production
+# 2. Rename this file to .env: mv .env.production .env
+# 3. Verify all required keys are set before deployment
+# 4. Test the application thoroughly in a staging environment first
+#
+# SECURITY NOTES:
+# - Never commit production API keys to version control
+# - Use environment-specific keys for production
+# - Rotate keys regularly for security
+# - Monitor usage and costs for all providers

FAQ.md

@@ -102,4 +102,32 @@ You will need to make sure you have the latest version of Visual Studio C++ inst
 
 ---
 
+<details>
+<summary><strong>What about free models and OpenRouter limitations?</strong></summary>
+
+Free models (especially on OpenRouter) can be a great starting point but have some limitations:
+
+**Common Issues:**
+- Rate limiting and usage restrictions
+- Slower response times during peak hours
+- Less consistent response quality
+- Higher chance of service interruptions
+
+**Best Practices:**
+- Use free models for simple tasks like code review or basic questions
+- Switch to paid models (Claude 3.5 Sonnet, GPT-4o) for complex development
+- The app shows visual warnings when using free models
+- Check our [Free Models Guide](../docs/free-models-guide.md) for detailed recommendations
+
+**Recommended Paid Alternatives:**
+- Claude 3.5 Sonnet (best overall performance)
+- GPT-4o (excellent for code generation)
+- DeepSeek Coder V2 (cost-effective, high quality)
+- Gemini 2.0 Flash (fast and reliable)
+
+The app includes smart recommendations and visual indicators to help you choose the right model for your needs.
+</details>
+
+---
+
 Got more questions? Feel free to reach out or open an issue in our GitHub repo!