VIBN Frontend for Coolify deployment

GEMINI_SETUP.md

@@ -0,0 +1,163 @@
+# Gemini AI Integration Setup
+
+The Getting Started page uses Google's Gemini AI to provide an intelligent onboarding experience.
+
+## 🔑 Get Your Gemini API Key
+
+1. Go to [Google AI Studio](https://makersuite.google.com/app/apikey)
+2. Click "Get API Key" or "Create API Key"
+3. Copy your API key
+
+## 🔧 Add to Environment Variables
+
+### Local Development
+
+Add to your `.env.local` file:
+
+```env
+GEMINI_API_KEY=your_gemini_api_key_here
+```
+
+### Vercel Production
+
+1. Go to your Vercel project dashboard
+2. Navigate to **Settings** → **Environment Variables**
+3. Add:
+   - **Key**: `GEMINI_API_KEY`
+   - **Value**: Your Gemini API key
+   - **Environment**: Production (and Preview if needed)
+4. Redeploy your application
+
+## 🤖 How It Works
+
+### Project Context
+
+When a user opens the Getting Started page, the AI automatically:
+
+1. **Checks project creation method**:
+   - Local workspace path
+   - GitHub repository
+   - ChatGPT conversation URL
+
+2. **Analyzes existing activity**:
+   - Counts coding sessions
+   - Reviews recent work
+   - Identifies what's been built
+
+3. **Provides personalized guidance**:
+   - Acknowledges existing progress
+   - Suggests next steps
+   - Answers questions about the project
+   - Helps break down goals into tasks
+
+### System Prompt
+
+The AI is instructed to:
+- Welcome users warmly
+- Reference their specific project details
+- Check for existing sessions and code
+- Provide actionable, step-by-step guidance
+- Ask clarifying questions
+- Help users make progress quickly
+
+### Data Available to AI
+
+The AI has access to:
+- **Project name** and **product vision**
+- **Project type** (manual, GitHub, ChatGPT, local)
+- **Workspace path** (if local folder was selected)
+- **GitHub repository** (if connected)
+- **ChatGPT URL** (if provided)
+- **Session count** and **recent activity**
+- **Conversation history** (during the chat session)
+
+## 📊 API Endpoint
+
+**Endpoint**: `POST /api/ai/chat`
+
+**Request**:
+```json
+{
+  "projectId": "string",
+  "message": "string",
+  "conversationHistory": [
+    { "role": "user|assistant", "content": "string" }
+  ]
+}
+```
+
+**Response**:
+```json
+{
+  "success": true,
+  "message": "AI response here",
+  "projectContext": {
+    "sessionCount": 5,
+    "hasWorkspace": true,
+    "hasGithub": false,
+    "hasChatGPT": false
+  }
+}
+```
+
+## 🔒 Security
+
+- API key is **server-side only** (never exposed to client)
+- User authentication required (Firebase ID token)
+- Project ownership verified
+- Rate limiting recommended (not yet implemented)
+
+## 💡 Tips
+
+### Prompt Engineering
+
+The system prompt can be modified in `/app/api/ai/chat/route.ts` to:
+- Change the AI's personality
+- Add specific instructions
+- Include additional context
+- Customize responses for different project types
+
+### Fallback Behavior
+
+If Gemini API fails:
+- Shows a friendly default message
+- Allows user to continue chatting
+- Logs errors for debugging
+
+### Cost Management
+
+Gemini Pro is currently free with rate limits:
+- 60 requests per minute
+- 1,500 requests per day
+
+For production, consider:
+- Implementing rate limiting per user
+- Caching common responses
+- Using Gemini Pro 1.5 for longer context
+
+## 🧪 Testing
+
+1. Start local dev server: `npm run dev`
+2. Navigate to any project's Getting Started page
+3. The AI should automatically greet you with context about your project
+4. Try asking questions like:
+   - "What should I build first?"
+   - "Help me understand my existing sessions"
+   - "What's the best way to organize my code?"
+
+## 📝 Customization
+
+To customize the AI behavior, edit the `systemPrompt` in:
+`/app/api/ai/chat/route.ts`
+
+You can:
+- Add more project context
+- Change the tone and style
+- Include specific frameworks or tools
+- Add code examples and templates
+- Integrate with other APIs or databases
+
+---
+
+**Questions?** Check the [Gemini API documentation](https://ai.google.dev/docs)
+