Documentation
For assistants
llms.txt, the registry and the conventions an assistant reads.
An assistant that writes interface code does better when it can find out what exists, when each thing is the right choice, and what correct use looks like. The library is written to answer those three questions from its own files.
The header of every file
Every component starts with what it is, when to use it and what to use instead when it is the wrong choice, and an example that works. This is the button's:
/**
* @name button
* @category ui
* @description A button, or a link that looks like one. Five variants, three sizes, a loading state.
* @when Any action. One "solid" per view for the main action; "outline" or "ghost" for the rest; "destructive" only for deleting.
* @example
* <Button>Save</Button>
* <Button variant="outline" size="sm">Cancel</Button>
* <Button asChild><a href="/pricing">See pricing</a></Button>
* <Button loading>Saving</Button>
*/Nothing else is listed by hand. What an item depends on is read from its imports.
llms.txt
https://ui.rivier.ai/llms.txt is every item with its purpose, when to use it and its example, in one plain file, generated from the headers. Give it to an assistant before it writes a component of its own.
The registry
registry.json lists every item, and /r/<name>.json holds one item with its source, in the shadcn registry format. Tools that read that format can install from here: see Installation.
curl https://ui.rivier.ai/r/button.jsonA page as Markdown
Each component's page has a button that copies the component as Markdown: its description, when to use it, how to add it and its example, ready to paste into a conversation.
Conventions
Conventions is how a component here is written. A project's own components can follow the same rules, so that the theme reaches them and an assistant can read them the same way.
What is not there yet
There is no MCP server of the library's own. The shadcn command's MCP server reads registries in this format, but it has not been tested with this one, so this site does not say it works.