Skip to main content
Clever Ops

Registry

CleverUI is distributed as a shadcn-compatible registry. All 506 components (and the seven theme presets) are public JSON payloads, the same endpoints power the CLI, the Open in v0 buttons, and any AI agent you point at them.

Endpoints

One payload per component, keyed by name:

Endpoint patterntext
https://cleverops.com.au/r/{name}.json

Payloads are served with CORS enabled and cached at the edge. Try one: /r/card-spotlight.json

Payload anatomy

Each payload follows the shadcn registry-item schema: full source inline, npm dependencies for the CLI to install, and registry dependencies for shared helpers.

registry-item shapejson
{
  "name": "card-spotlight",
  "type": "registry:ui",
  "dependencies": ["motion"],
  "registryDependencies": ["utils"],
  "files": [
    {
      "path": "registry/cards/card-spotlight/card-spotlight.tsx",
      "type": "registry:ui",
      "content": "(full component source, inlined)"
    }
  ]
}

Using the namespace

Register once in components.json, then every install command is @cleverui/<name>:

components.jsonjson
{
  "registries": {
    "@cleverui": "https://cleverops.com.au/r/{name}.json"
  }
}

Full walkthrough on the installation page.

For AI tools and agents

Open in v0

Every component page has an Open in v0 button, it hands the component's registry payload to v0.dev so you can iterate on it in a generative editor before bringing it home.

llms.txt

A machine-readable index of the whole library lives at /llms.txt , point an AI agent at it to discover every component, or use the agent prompt on any component page for a ready-made install instruction.

Frequently asked questions

Can I use the registry endpoints directly, without the shadcn CLI?

Yes. Every payload is public JSON with CORS enabled, fetch /r/<name>.json from any tool, script, or agent. The files array carries the complete component source inline, so nothing else is needed to consume a component programmatically.

What does the utils registry dependency mean?

It is the shadcn cn() class-merge helper. When a payload lists utils under registryDependencies, the CLI ensures your project has lib/utils.ts, it comes free with npx shadcn init and is the only shared code CleverUI components assume.

Are the theme presets installable too?

Yes, the seven CleverUI theme presets are registry:theme items (for example /r/theme-verdigris.json). Installing one writes its CSS variables into your project the same way the theme customizer's "Copy theme" block does.