# VP0

> VP0 is a free, forever-free library of iOS app design starters (Expo React Native) built for AI app builders. Find a design, and your AI tool pulls the complete, import-ready source: files, dependencies, the exact install command, and step-by-step integration. No account and no API key are needed to use designs. The design link is the key.

VP0 is meant to be consumed by AI agents and builders such as Claude Code, Cursor, Windsurf, Rork, and Lovable. The fastest path is the MCP server; the copy-link flow and the JSON API work without it.

## Use VP0 from your AI builder (MCP, recommended)

Install the free MCP server once, then ask your tool for designs by name (no link to copy):

- Claude Code: `claude mcp add vp0 -- npx -y vp0-mcp`
- Cursor / Windsurf, add to the MCP config: `{ "mcpServers": { "vp0": { "command": "npx", "args": ["-y", "vp0-mcp"] } } }`
- Tools: `search_vp0_designs(query)` returns matching designs (name, slug, link); `get_vp0_design(slug)` returns the full import-ready manifest (inline files, dependencies, install command, ordered integration steps).
- Package: https://www.npmjs.com/package/vp0-mcp
- Self-hosted MCP discovery (canonical, no third party): `https://api.vp0.com/mcp/server.json` and `https://api.vp0.com/.well-known/mcp.json`

## Or install a design with the VP0 CLI (no MCP, no key)

VP0 ships its own installer that talks only to its own API:

- `npx vp0com search <query>` — find designs
- `npx vp0com add <slug> --target react-native --install` — write the files + install deps
- `npx vp0com add <slug>@<version>` — pin an immutable version
- Or use a stock shadcn CLI: `npx shadcn add https://api.vp0.com/r/<slug>.json`
- Package: https://www.npmjs.com/package/vp0

## Import a design without the MCP (copy-link flow)

1. Browse designs at https://vp0.com/explore
2. Open a design, copy its link, or go to its source page directly: `https://vp0.com/source/<slug>`
3. The source page is server-rendered and AI-readable: a paste-ready prompt, the exact install command, ordered integration steps, and every source file inline.
4. For a single machine-readable payload, fetch the manifest JSON: `https://api.vp0.com/designs/<slug>/manifest`

## API (open, no key)

- Browse and search designs: `https://api.vp0.com/contents?search=<query>`
- Design manifest (JSON): `https://api.vp0.com/designs/<slug>/manifest`
- OpenAPI spec: https://api.vp0.com/api/openapi.json
- The public read API is CORS-open and needs no key. Use it to discover designs, then pull a manifest to import one.

## Registry (shadcn/MCP-aligned, open, no key)

Every design is a `vp0-bundle.v1` manifest whose top level mirrors a shadcn registry-item, so shadcn- or MCP-aware tools can ingest it directly (React Native files are just `.tsx` written to each file's `target`). VP0 specifics live under `meta` (reverse-DNS `com.vp0.*`).

- Registry index (enumerate the whole library): `https://api.vp0.com/registry.json`
- Bundle manifest (alias): `https://api.vp0.com/r/<slug>.json`
- Single language only: `https://api.vp0.com/r/<slug>/react-native.json` or `.../swiftui.json` (or `?target=`)
- File tree: `https://api.vp0.com/designs/<slug>/files`
- One raw file: `https://api.vp0.com/designs/<slug>/raw?path=<path>&language=<target>`
- Download everything as a zip: `https://api.vp0.com/designs/<slug>/bundle.zip`
- JSON Schema for the manifest: `https://api.vp0.com/schema/vp0-bundle.v1.json`
- Pin an immutable version: `https://api.vp0.com/r/<slug>@<version>.json` (or `?version=`); `/r/<slug>.json` is always latest. Each manifest carries a `sourceHash` to verify integrity.
- React Native is the default target; SwiftUI is optional and appears only when a design ships it.

## Browse by category

Designs are organized into categories you can browse or filter. Hub:
`https://vp0.com/explore`; a single category: `https://vp0.com/category/<slug>`;
the list with live counts: `https://api.vp0.com/categories`.

Categories: fitness, finance, dating, productivity, wellness, fashion, skincare,
beauty, food, travel, social, ai, education, health, shopping, lifestyle, music,
journaling, meditation, habit-tracking, calendar, dashboard, messaging, crypto,
sleep, pets, parenting, nutrition, events, weather, notes, tasks, coaching,
real-estate, community, portfolio, business, goal-tracking, mood-tracking.

## Notes

- These are iOS app UI starters (Expo React Native), and many also ship a SwiftUI
  version of the same screen. Add your own backend and data logic.
- Free forever, no monetization. Built for the era of vibe-coded mobile apps.

## Links

- Home: https://vp0.com
- Use from your AI builder (MCP, CLI, copy-link): https://vp0.com/mcp
- Explore: https://vp0.com/explore
- New: https://vp0.com/new
- Popular: https://vp0.com/popular
- MCP on npm: https://www.npmjs.com/package/vp0-mcp