Main

CONTRIBUTING.md

@@ -31,8 +31,8 @@ deployed using [CloudFlare Pages](https://pages.cloudflare.com/) and
 ### AI SDK Integration
 
 Bolt uses the [AI SDK](https://github.com/vercel/ai) to integrate with AI
-models. At this time, Bolt supports using Anthropic's Claude Sonnet 3.5.
-You can get an API key from the [Anthropic API Console](https://console.anthropic.com/) to use with Bolt.
+models. Imoogle Build supports using Mistral and Groq as the default providers.
+You can get API keys from the [Mistral AI Console](https://console.mistral.ai/) or [Groq Console](https://console.groq.com/) to use with Imoogle Build.
 Take a look at how [Bolt uses the AI SDK](https://github.com/stackblitz/bolt.new/tree/main/app/lib/.server/llm)
 
 ## Prerequisites
@@ -56,12 +56,15 @@ git clone https://github.com/stackblitz/bolt.new.git
 pnpm install
 ```
 
-3. Create a `.env.local` file in the root directory and add your Anthropic API key:
+3. Create a `.env.local` file in the root directory and add your API keys:
 
 ```
-ANTHROPIC_API_KEY=XXX
+MISTRAL_API_KEY=your_mistral_api_key_here
+GROQ_API_KEY=your_groq_api_key_here
 ```
 
+Note: You can use either Mistral or Groq (or both). Mistral is the primary provider with Groq as fallback.
+
 Optionally, you can set the debug level:
 
 ```

DEPLOYMENT.md

@@ -0,0 +1,222 @@
+# Deploying Imoogle Build to Vercel
+
+This guide will help you deploy **Imoogle Build** to Vercel.
+
+## Prerequisites
+
+Before deploying, you'll need:
+
+1. **AI Provider API Keys** (at least one):
+   - [Mistral API Key](https://console.mistral.ai/) - Primary provider
+   - [Groq API Key](https://console.groq.com/) - Fallback provider
+
+2. **Vercel Account**
+   - Sign up at [vercel.com](https://vercel.com)
+
+## Quick Deploy
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/your-username/imoogle-build)
+
+## Manual Deployment
+
+### 1. Clone and Setup
+
+```bash
+git clone <your-repository-url>
+cd imoogle-build
+pnpm install
+```
+
+### 2. Environment Variables
+
+Create a `.env.local` file for local development:
+
+```bash
+# AI Provider API Keys (at least one is required)
+MISTRAL_API_KEY=your_mistral_api_key_here
+GROQ_API_KEY=your_groq_api_key_here
+
+# Optional: Debug level
+DEBUG_LEVEL=info
+VITE_LOG_LEVEL=info
+```
+
+### 3. Local Development
+
+```bash
+# Start development server
+pnpm dev
+
+# Build for production (test before deploying)
+pnpm build
+
+# Preview production build locally
+pnpm preview
+```
+
+### 4. Deploy to Vercel
+
+#### Option A: Using Vercel CLI
+
+```bash
+# Install Vercel CLI
+npm i -g vercel
+
+# Deploy
+vercel
+
+# Set environment variables
+vercel env add MISTRAL_API_KEY production
+vercel env add GROQ_API_KEY production
+
+# Set for preview environment too
+vercel env add MISTRAL_API_KEY preview
+vercel env add GROQ_API_KEY preview
+```
+
+#### Option B: Using Vercel Dashboard
+
+1. **Connect Repository**
+   - Go to [Vercel Dashboard](https://vercel.com/dashboard)
+   - Click "New Project"
+   - Import your Git repository
+
+2. **Configure Build Settings**
+   - Framework Preset: **Remix**
+   - Build Command: `pnpm build`
+   - Output Directory: `build`
+   - Install Command: `pnpm install`
+
+3. **Set Environment Variables**
+   - Go to Project Settings → Environment Variables
+   - Add the following variables:
+
+   | Name | Value | Environment |
+   |------|-------|-------------|
+   | `MISTRAL_API_KEY` | `your-actual-mistral-api-key` | Production, Preview |
+   | `GROQ_API_KEY` | `your-actual-groq-api-key` | Production, Preview |
+
+   **Important**: 
+   - Enter the actual API key values, not references
+   - Make sure to select both "Production" and "Preview" environments
+   - The variable names are case-sensitive
+
+4. **Deploy**
+   - Click "Deploy"
+   - Wait for deployment to complete
+
+## Configuration Details
+
+### Vercel Configuration
+
+The project includes a `vercel.json` file with the following configuration:
+
+```json
+{
+  "buildCommand": "pnpm build",
+  "devCommand": "pnpm dev",
+  "installCommand": "pnpm install",
+  "framework": "remix",
+  "outputDirectory": "build",
+  "functions": {
+    "app/routes/api.*.ts": {
+      "maxDuration": 30
+    }
+  }
+}
+```
+
+**Note**: Environment variables are set directly in the Vercel dashboard or CLI, not in the `vercel.json` file.
+
+### AI Provider Fallback Logic
+
+- **Primary**: Mistral AI (if `MISTRAL_API_KEY` is provided)
+- **Fallback**: Groq (if `GROQ_API_KEY` is provided)
+- **Error**: If neither API key is provided, the app will throw an error
+
+### Supported Models
+
+- **Mistral**: `mistral-large-latest`
+- **Groq**: `llama3-8b-8192`
+
+## Troubleshooting
+
+### Environment Variable Issues
+
+1. **"Secret does not exist" Error**
+   - This happens when environment variables are not set correctly
+   - Go to Project Settings → Environment Variables in Vercel dashboard
+   - Add `MISTRAL_API_KEY` and/or `GROQ_API_KEY` with actual values
+   - Redeploy the project
+
+2. **Variables Not Loading**
+   - Ensure variables are set for the correct environment (Production/Preview)
+   - Variable names must be exactly: `MISTRAL_API_KEY` and `GROQ_API_KEY`
+   - Redeploy after adding new environment variables
+
+3. **Build Failures**
+   ```bash
+   # Clear cache and rebuild
+   pnpm clean
+   pnpm install
+   pnpm build
+   ```
+
+### Common Issues
+
+1. **API Key Issues**
+   - Ensure environment variables are set correctly in Vercel dashboard
+   - Verify API keys are valid and have sufficient credits
+   - Check that you're using the correct API key format
+
+2. **Memory/Timeout Issues**
+   - API routes have a 30-second timeout limit
+   - Large responses are streamed to avoid memory issues
+
+### Step-by-Step Environment Variable Setup
+
+1. **In Vercel Dashboard:**
+   - Go to your project
+   - Click "Settings" tab
+   - Click "Environment Variables" in the sidebar
+   - Click "Add New"
+   - Enter `MISTRAL_API_KEY` as name
+   - Enter your actual Mistral API key as value
+   - Select "Production" and "Preview" environments
+   - Click "Save"
+   - Repeat for `GROQ_API_KEY` if you have one
+
+2. **Redeploy:**
+   - Go to "Deployments" tab
+   - Click "..." menu on latest deployment
+   - Click "Redeploy"
+
+## Performance Optimization
+
+1. **Code Splitting**: The app automatically splits code for better performance
+2. **Streaming**: API responses are streamed to handle large responses
+3. **Caching**: Static assets are automatically cached by Vercel
+
+## Monitoring
+
+- **Vercel Analytics**: Monitor performance and usage
+- **Function Logs**: Check Vercel function logs for API errors
+- **Build Logs**: Monitor build process for any issues
+
+## Security
+
+- **Environment Variables**: Never commit API keys to your repository
+- **HTTPS**: Vercel automatically provides HTTPS
+- **CORS**: Configured for same-origin requests
+
+## Support
+
+If you encounter issues:
+
+1. Check [Vercel Documentation](https://vercel.com/docs)
+2. Review [Remix Deployment Guide](https://remix.run/docs/en/main/guides/deployment#vercel)
+3. Check project issues on GitHub
+
+---
+
+**Note**: This deployment guide assumes you've already completed the rebranding to "Imoogle Build" and have configured Mistral/Groq as your AI providers.

README.md

@@ -1,54 +1,63 @@
-[![Bolt.new: AI-Powered Full-Stack Web Development in the Browser](./public/social_preview_index.jpg)](https://bolt.new)
+[![Imoogle Build: AI-Powered Full-Stack Web Development in the Browser](./public/social_preview_index.jpg)](https://imoogle-build.com)
 
-# Bolt.new: AI-Powered Full-Stack Web Development in the Browser
+# Imoogle Build: AI-Powered Full-Stack Web Development in the Browser
 
-Bolt.new is an AI-powered web development agent that allows you to prompt, run, edit, and deploy full-stack applications directly from your browser—no local setup required. If you're here to build your own AI-powered web dev agent using the Bolt open source codebase, [click here to get started!](./CONTRIBUTING.md)
+Imoogle Build is an AI-powered web development agent that allows you to prompt, run, edit, and deploy full-stack applications directly from your browser—no local setup required. Built with Mistral and Groq AI models for enhanced performance and capabilities.
 
-## What Makes Bolt.new Different
+## What Makes Imoogle Build Different
 
-Claude, v0, etc are incredible- but you can't install packages, run backends or edit code. That’s where Bolt.new stands out:
+Traditional AI assistants are incredible, but you can't install packages, run backends or edit code. That's where Imoogle Build stands out:
 
-- **Full-Stack in the Browser**: Bolt.new integrates cutting-edge AI models with an in-browser development environment powered by **StackBlitz’s WebContainers**. This allows you to:
+- **Full-Stack in the Browser**: Imoogle Build integrates cutting-edge AI models (Mistral and Groq) with an in-browser development environment powered by **StackBlitz's WebContainers**. This allows you to:
   - Install and run npm tools and libraries (like Vite, Next.js, and more)
   - Run Node.js servers
   - Interact with third-party APIs
   - Deploy to production from chat
   - Share your work via a URL
 
-- **AI with Environment Control**: Unlike traditional dev environments where the AI can only assist in code generation, Bolt.new gives AI models **complete control** over the entire  environment including the filesystem, node server, package manager, terminal, and browser console. This empowers AI agents to handle the entire app lifecycle—from creation to deployment.
+- **AI with Environment Control**: Unlike traditional dev environments where the AI can only assist in code generation, Imoogle Build gives AI models **complete control** over the entire environment including the filesystem, node server, package manager, terminal, and browser console. This empowers AI agents to handle the entire app lifecycle—from creation to deployment.
 
-Whether you’re an experienced developer, a PM or designer, Bolt.new allows you to build production-grade full-stack applications with ease.
+Whether you're an experienced developer, a PM or designer, Imoogle Build allows you to build production-grade full-stack applications with ease.
 
-For developers interested in building their own AI-powered development tools with WebContainers, check out the open-source Bolt codebase in this repo!
+## Supported AI Providers
+
+Imoogle Build uses the following AI providers by default:
+- **Mistral AI**: Primary provider for enhanced reasoning and code generation
+- **Groq**: Fallback provider for fast inference and reliability
 
 ## Tips and Tricks
 
-Here are some tips to get the most out of Bolt.new:
+Here are some tips to get the most out of Imoogle Build:
 
-- **Be specific about your stack**: If you want to use specific frameworks or libraries (like Astro, Tailwind, ShadCN, or any other popular JavaScript framework), mention them in your initial prompt to ensure Bolt scaffolds the project accordingly.
+- **Be specific about your stack**: If you want to use specific frameworks or libraries (like Astro, Tailwind, ShadCN, or any other popular JavaScript framework), mention them in your initial prompt to ensure Imoogle Build scaffolds the project accordingly.
 
 - **Use the enhance prompt icon**: Before sending your prompt, try clicking the 'enhance' icon to have the AI model help you refine your prompt, then edit the results before submitting.
 
-- **Scaffold the basics first, then add features**: Make sure the basic structure of your application is in place before diving into more advanced functionality. This helps Bolt understand the foundation of your project and ensure everything is wired up right before building out more advanced functionality.
+- **Scaffold the basics first, then add features**: Make sure the basic structure of your application is in place before diving into more advanced functionality. This helps Imoogle Build understand the foundation of your project and ensure everything is wired up right before building out more advanced functionality.
 
-- **Batch simple instructions**: Save time by combining simple instructions into one message. For example, you can ask Bolt to change the color scheme, add mobile responsiveness, and restart the dev server, all in one go saving you time and reducing API credit consumption significantly.
+- **Batch simple instructions**: Save time by combining simple instructions into one message. For example, you can ask Imoogle Build to change the color scheme, add mobile responsiveness, and restart the dev server, all in one go saving you time and reducing API credit consumption significantly.
 
-## FAQs
+## Setup
+
+To run Imoogle Build locally, you'll need API keys for either Mistral or Groq (or both):
 
-**Where do I sign up for a paid plan?**  
-Bolt.new is free to get started. If you need more AI tokens or want private projects, you can purchase a paid subscription in your [Bolt.new](https://bolt.new) settings, in the lower-left hand corner of the application. 
+1. Get a Mistral API key from [Mistral AI Console](https://console.mistral.ai/)
+2. Get a Groq API key from [Groq Console](https://console.groq.com/)
 
-**What happens if I hit the free usage limit?**  
-Once your free daily token limit is reached, AI interactions are paused until the next day or until you upgrade your plan.
+Create a `.env.local` file in the root directory and add your API keys:
 
-**Is Bolt in beta?**  
-Yes, Bolt.new is in beta, and we are actively improving it based on feedback.
+```bash
+MISTRAL_API_KEY=your_mistral_api_key_here
+GROQ_API_KEY=your_groq_api_key_here
+```
+
+## FAQs
 
-**How can I report Bolt.new issues?**  
-Check out the [Issues section](https://github.com/stackblitz/bolt.new/issues) to report an issue or request a new feature. Please use the search feature to check if someone else has already submitted the same issue/request.
+**What frameworks/libraries currently work on Imoogle Build?**  
+Imoogle Build supports most popular JavaScript frameworks and libraries. If it runs on StackBlitz, it will run on Imoogle Build as well.
 
-**What frameworks/libraries currently work on Bolt?**  
-Bolt.new supports most popular JavaScript frameworks and libraries. If it runs on StackBlitz, it will run on Bolt.new as well.
+**Which AI models does Imoogle Build use?**  
+Imoogle Build primarily uses Mistral's latest models with Groq as a fallback provider for enhanced performance and reliability.
 
-**How can I add make sure my framework/project works well in bolt?**  
-We are excited to work with the JavaScript ecosystem to improve functionality in Bolt. Reach out to us via [[email protected]](mailto:[email protected]) to discuss how we can partner!
+**How can I report issues?**  
+Check out the [Issues section](https://github.com/your-repo/imoogle-build/issues) to report an issue or request a new feature. Please use the search feature to check if someone else has already submitted the same issue/request.