Files
vibn-frontend/V0-SETUP.md

2.7 KiB

v0 API Setup

Quick Start

1. Add Your API Key

Create a .env.local file in the vibn-frontend directory:

cd /Users/markhenderson/ai-proxy/vibn-frontend
touch .env.local

Add your v0 API key:

# v0 API Key
V0_API_KEY=v1:GjJL450FZD5bJsMSw1NQrvNE:3yLQa91hjOKA0WohS0tLQODg

# Database (already configured in code, but can override here)
DATABASE_URL=postgresql://postgres:jhsRNOIyjjVfrdvDXnUVcXXXsuzjvcFc@metro.proxy.rlwy.net:30866/railway

2. Restart Your Dev Server

# Stop the current server (Ctrl+C)
# Then restart:
pnpm dev

3. Test the Integration

  1. Navigate to UI UX section (http://localhost:3000/1/design)
  2. Enter a design prompt, e.g.:
    Create a modern pricing section with 3 tiers. Include a hero heading, 
    feature lists with checkmarks, and call-to-action buttons. Use Tailwind CSS.
    
  3. (Optional) Select a style: Modern, Minimal, Colorful, etc.
  4. Click Generate Design
  5. v0 will open in a new tab with your generated design!

How It Works

API Flow

User Input → UI UX Page → /api/v0/generate → v0 SDK → v0.dev
                ↓
            New Tab Opens with Generated Design

Files Changed

  1. app/api/v0/generate/route.ts - API endpoint that calls v0
  2. app/(dashboard)/[projectId]/design/page.tsx - UI with working form
  3. .env.local - Your API key (create this manually)

Features

Real-time Generation - Submit prompt → Generate with v0 → Opens in new tab
Style Selection - Choose from 5 different design aesthetics
Loading States - Spinner, disabled inputs, toast notifications
Error Handling - Graceful failures with user-friendly messages
Auto-clear Form - Prompt resets after successful generation

Troubleshooting

"V0_API_KEY not configured" Error

  • Make sure .env.local exists in /Users/markhenderson/ai-proxy/vibn-frontend/
  • Verify the file contains V0_API_KEY=v1:...
  • Restart your dev server (pnpm dev)

Generation Takes Too Long

Design Doesn't Open

  • Check browser popup blocker settings
  • Manually visit the v0 URL shown in the toast notification

Next Steps

Once basic generation is working:

  1. Save to Database - Store generated designs in PostgreSQL
  2. Design Gallery - Display your created designs (currently shows mock data)
  3. Thumbnail Generation - Capture screenshots of v0 designs
  4. Feedback System - Allow team comments on designs
  5. Share Links - Generate public URLs for client feedback

All implementation details are in V0-INTEGRATION.md! 🚀