---
name: aicre8
description: AI website builder API. Create, edit, and deploy full-stack websites from text prompts. Use when building websites, landing pages, portfolios, token sites, or prototypes. Generates React + Tailwind sites with permanent hosting at {slug}.aicre8.app.
---

# aicre8.dev

> AI website builder. Create, edit, preview, and publish websites from a single prompt. Ships full-stack sites with hosting included.

## Platform

- **Base URL**: `https://aicre8.dev`
- **Auth**: API key (`ak_live_` prefix). Get one at `https://aicre8.dev/settings/api-keys`.
- **Hosting**: Every site gets a permanent URL at `{slug}.aicre8.app`.
- **Stack**: AI generates Vite + React + Tailwind sites. Remix projects available on Pro tier.
- **Rate Limits**: 20 requests/minute per API key.

## Skills

### create_project

Create a new website project from a text prompt. The AI generates a complete site with all files.

```
POST /api/v1/projects
Authorization: Bearer ak_live_YOUR_KEY
Content-Type: application/json

{
  "prompt": "A landing page for a coffee shop called Bean & Brew with dark theme, hero image, menu section, and contact form",
  "template": "react-vite"
}
```

Response:

```json
{
  "success": true,
  "data": {
    "projectId": "uuid",
    "previewUrl": "https://bean-and-brew.aicre8.app",
    "editorUrl": "https://aicre8.dev/chat/uuid",
    "status": "building"
  }
}
```

Templates: `react-vite` (default), `remix` (Pro), `static-html`.

The AI generates: index page, components, styles, assets, package.json, and deploys automatically.

---

### edit_project

Send a follow-up prompt to modify an existing project.

```
POST /api/v1/projects/{projectId}/edit
Authorization: Bearer ak_live_YOUR_KEY
Content-Type: application/json

{
  "prompt": "Add a testimonials section with 3 customer reviews and star ratings"
}
```

Response:

```json
{
  "success": true,
  "data": {
    "projectId": "uuid",
    "filesChanged": ["src/components/Testimonials.tsx", "src/App.tsx"],
    "previewUrl": "https://bean-and-brew.aicre8.app",
    "status": "updated"
  }
}
```

The AI reads existing files, understands the project structure, and makes targeted edits.

---

### upload_image

Upload an image (logo, photo, asset) to use in a project.

```
POST /api/v1/projects/{projectId}/upload
Authorization: Bearer ak_live_YOUR_KEY
Content-Type: multipart/form-data

file: (binary)
path: "public/logo.png"
```

Response:

```json
{
  "success": true,
  "data": {
    "path": "public/logo.png",
    "size": 48230,
    "url": "https://bean-and-brew.aicre8.app/logo.png"
  }
}
```

Supported: PNG, JPG, JPEG, GIF, WEBP, SVG, ICO, WOFF, WOFF2, PDF (max 5MB).

---

### deploy_project

Publish a project to its permanent URL.

```
POST /api/v1/projects/{projectId}/deploy
Authorization: Bearer ak_live_YOUR_KEY
```

Response:

```json
{
  "success": true,
  "data": {
    "url": "https://bean-and-brew.aicre8.app",
    "deployId": "deploy_abc123",
    "status": "live"
  }
}
```

Sites are deployed to Cloudflare's global CDN. Custom domains supported on Pro tier.

---

### list_projects

List all projects for the authenticated user.

```
GET /api/v1/projects
Authorization: Bearer ak_live_YOUR_KEY
```

Response:

```json
{
  "success": true,
  "data": {
    "projects": [
      {
        "id": "uuid",
        "title": "Bean & Brew",
        "url": "https://bean-and-brew.aicre8.app",
        "status": "live",
        "createdAt": "2026-03-12T10:00:00Z",
        "updatedAt": "2026-03-12T10:05:00Z"
      }
    ]
  }
}
```

---

### get_project

Get details and file listing for a specific project.

```
GET /api/v1/projects/{projectId}
Authorization: Bearer ak_live_YOUR_KEY
```

Response:

```json
{
  "success": true,
  "data": {
    "id": "uuid",
    "title": "Bean & Brew",
    "url": "https://bean-and-brew.aicre8.app",
    "status": "live",
    "files": [
      "src/App.tsx",
      "src/components/Hero.tsx",
      "src/components/Menu.tsx",
      "src/components/Contact.tsx",
      "public/logo.png",
      "package.json",
      "index.html"
    ],
    "createdAt": "2026-03-12T10:00:00Z"
  }
}
```

## Full Agent Pipeline

1. **Create project**: `POST /api/v1/projects` with a descriptive prompt
2. **Upload assets**: `POST /api/v1/projects/{id}/upload` — logos, images, fonts
3. **Iterate**: `POST /api/v1/projects/{id}/edit` — refine with follow-up prompts
4. **Deploy**: `POST /api/v1/projects/{id}/deploy` — publish to `{slug}.aicre8.app`
5. **Check status**: `GET /api/v1/projects/{id}` — verify deployment

## Use Cases

- **Token websites**: Build landing pages for crypto tokens (integrates with [vybes.fun](https://vybes.fun))
- **Business sites**: Landing pages, portfolios, SaaS marketing sites
- **Event pages**: Conference, launch event, or campaign pages
- **Documentation**: Product docs and knowledge bases
- **Prototypes**: Rapid UI prototyping from descriptions

## Pricing

| Tier | Price | Projects | Features |
|------|-------|----------|----------|
| Free | £0/mo | 3 | React + Tailwind, aicre8.app hosting |
| Pro | £20/mo | Unlimited | Remix, custom domains, API access |
| Business | £50/mo | Unlimited | Priority AI, team collaboration |
| Agency | £200/mo | Unlimited | White-label, client management |

## Integration with Vybes.fun

Agents using [vybes.fun](https://vybes.fun) can build token websites via aicre8:

```
1. Launch token on vybes.fun
2. POST /api/v1/projects with token metadata in prompt
3. Deploy → get {slug}.aicre8.app URL
4. Link back: POST vybes.fun/api/token/link-project
```

See [vybes.fun/skill.md](https://vybes.fun/skill.md) for the full vybes agent API.

## Notes

- All endpoints return `{ "success": true/false, ... }` JSON
- CORS enabled on all API endpoints
- API keys can be scoped: `projects:read`, `projects:write`, `generate`, `deploy`
- Rate limited: 20 req/min per key, 100 projects per free tier
- Sites stay live permanently on free tier (no expiry)
