Quick Start (Copy & Run)

Replace only the API key and run. Both patterns below are 1 API call = 1 credit.

Antigravity: One-shot Prompt (high-impact, 1 call)
Use this single API call and make the Admin upload page change visibly in one shot.

curl -X GET "https://vibeui.org/api/v1/designs/search?q=dramatic+high-contrast+stylish+admin+dashboard+premium+cards+glassmorphism&category=part&limit=1&candidate_pool=100&temperature=1.2&jitter=0.2"   -H "Authorization: Bearer vui_sk_xxxxxxxxxxxx"   -H "X-Client-App: antigravity"   -H "X-AI-Agent: your-model"

Mandatory implementation rules:
1) Apply returned html + css together (never css-only patching).
2) Replace page structure/classes where needed (container/card/header/actions/list rows).
3) Remove conflicting inline styles before applying selected css.
4) Keep scope limited to admin page only (scoped CSS or CSS Modules if not using Tailwind).
5) Target obvious visual delta: typography, spacing scale, card depth, button style, and accent colors.
6) Return before/after summary and changed files.

Base URL: https://vibeui.org/api/v1

This block is ready to paste into Antigravity as-is.

Use the exact host https://vibeui.org and avoid extra trailing slashes in API paths to prevent 308 redirect auth-header issues on strict clients.

Pattern 1: AI-guided discovery (1 call / 1 credit)
curl -X GET "https://vibeui.org/api/v1/designs/search?q=surprise+me+with+a+modern+landing+component&category=lp&limit=1"   -H "Authorization: Bearer vui_sk_xxxxxxxxxxxx"   -H "X-Client-App: antigravity"   -H "X-AI-Agent: your-model"
Pattern 2: Design-specified search (1 call / 1 credit)
curl -X GET "https://vibeui.org/api/v1/designs/search?design_key=glassmorphism+card+dark&category=part&limit=1"   -H "Authorization: Bearer vui_sk_xxxxxxxxxxxx"   -H "X-Client-App: antigravity"   -H "X-AI-Agent: your-model"

API Documentation

VibeUI provides a REST API for AI agents and developers to search and retrieve premium UI components. Every design in our library is AI-analyzed with semantic embeddings, enabling natural-language search.

Base URL: https://vibeui.org/api/v1

Authentication

All API requests require a Bearer token. Create an API key from your Dashboard.

Header
Authorization: Bearer vui_sk_xxxxxxxxxxxx

For the fastest test, replace only the API key in the header and keep the full URL host (https://vibeui.org).

Optional Headers

X-Client-AppYour application name (e.g. "cursor", "windsurf")
X-AI-AgentAI model identifier (e.g. "claude-3.5-sonnet")
GET

Get Design by ID

Retrieve a single published design with full HTML/CSS payload. Search already includes html/css, so this is optional for re-fetch/verification. Requires API key and costs 1 credit. For `theme`, explicit confirmation (`confirm_theme=true`) is required to avoid accidental high-impact fetches.

Endpoint
GET /api/v1/designs/{id}?category={part|lp|theme}&confirm_theme={true|false}

Parameters

ParamTypeRequiredDescription
iduuidDesign ID from search results or design detail pages

Example Request

cURL
curl -X GET \
  "https://vibeui.org/api/v1/designs/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer vui_sk_xxxxxxxxxxxx"
POST

Submit Design

Submit a new UI component. The AI pipeline will automatically sanitize the code, generate quality scores, extract metadata, and create semantic embeddings.

Endpoint
POST /api/v1/designs/submit

Request Body

JSON
{
  "html": "<div class=\"my-component\">...</div>",
  "css": ".my-component { ... }",
  "title": "Optional Custom Title",
  "category": "part"
}

Response

201 Created
{
  "success": true,
  "design": {
    "id": "...",
    "title": "AI Generated Title",
    "description": "...",
    "ai_friendly_score": 0.87,
    "metadata": {
      "tags": ["button", "gradient", "animated"],
      "mood": ["playful", "vibrant"],
      "colorPalette": ["#ff6b6b", "#ffd93d"],
      "designPattern": "button"
    }
  },
  "submissions_today": 3,
  "daily_limit": 5
}

Credits & Billing

VibeUI uses an atomic credit system. New users receive free credits to get started.

ActionCostNotes
Search (per request)1 creditReturns up to 20 designs
Get design by ID (per request)1 creditOptional re-fetch/verification endpoint
Submit designFreeLimited to 5/day

Error Codes

StatusMeaning
400Bad Request — missing or invalid parameters
401Unauthorized — invalid or missing API key
402Payment Required — insufficient credits
429Too Many Requests — rate limit or daily submit limit exceeded
500Server Error — please retry or contact support

Rate Limits

API rate limits are enforced per API key.

EndpointLimit
/api/v1/designs/search60 requests/min
/api/v1/designs/submit5 per day (free tier)