Fable UI is a copy-and-own registry. The canonical public item address is:
https://fable-ui.shobky.com/r/<item>.jsonFor example:
pnpm dlx shadcn@latest add https://fable-ui.shobky.com/r/metric-card.jsonThe hosted JSON is the consumer-facing install surface. The repository's registry.json is its source definition; do not substitute a GitHub shorthand when you want to install the deployed public item.
Catalog#
| Item | Registry type | Installed concern |
|---|---|---|
core | registry:lib | Shared Fable core, including the renderer, provider, schemas, and data registry. |
metric-card | registry:component | Metric UI, show_metric, and its manifest. |
suggested-actions | registry:component | Prompt suggestions, show_next_actions, and its manifest. |
confirmation-card | registry:component | Confirmation UI, request_confirmation, and its manifest. |
form-card | registry:component | Form UI, collect_input, and its manifest. |
data-browser | registry:block | Browser and table UI, show_table, show_data_browser, get_rendered_data, and display manifests. |
charts | registry:block | Chart UI, show_chart, and its manifest. |
text-editor-card | registry:component | Draft UI, show_text_editor, and its manifest. |
email-composer-card | registry:component | Email draft UI, show_email_composer, and its manifest. |
code-block-card | registry:component | Code UI, show_code_block, and its manifest. |
rest-driver | registry:lib | Host-owned REST resource adapter. |
firebase-driver | registry:lib | Host-owned Firestore resource adapter. |
quickstart | registry:block | Minimal /fable-chat example with metric and suggested-action tools only. |
core is normally pulled in by a surface. It remains directly installable for a custom renderer or data-source integration.
What an item can install#
An item is more than a React file. Across the public catalog, an item can install all of these target categories:
| Target category | Examples |
|---|---|
| Core libraries | @lib/fable-ui/core/* |
| Components and blocks | @components/fable-ui/<item>/* |
| Tool contracts | @lib/fable-ui/tools/* |
| Model manifests | @lib/fable-ui/manifests/* |
| Shared hooks | @hooks/use-copy-to-clipboard.ts |
| Driver adapters | @lib/fable-ui/drivers/rest/*, @lib/fable-ui/drivers/firebase/* |
| shadcn primitives | Host components/ui/* files selected from registryDependencies |
| Next routes | app/fable-chat/page.tsx, app/api/fable-chat/route.ts |
| Quickstart client code | @components/fable-ui/chat/*, @lib/fable-ui/quickstart/* |
| Quickstart documentation | ~/docs/fable-ui/quickstart.md |
The @components, @lib, and @hooks prefixes are resolved through the host components.json; they are not fixed source paths. app/... targets are explicit Next route paths. This distinction lets each host keep its own aliases while keeping quickstart routes predictable.
Dependencies#
Bare registryDependencies such as card or button are official shadcn items. Fable dependencies are declared as repository references so the CLI installs the required Fable source with the item.
Install the public hosted item URL directly, then let the CLI resolve the source graph:
pnpm dlx shadcn@latest add https://fable-ui.shobky.com/r/email-composer-card.jsonInspect first when the host already owns nearby files:
pnpm dlx shadcn@latest add https://fable-ui.shobky.com/r/email-composer-card.json --dry-runBoundary#
Registry installation copies source into the host project. It does not configure authentication, data access, provider credentials, permissions, database access, mail delivery, or side effects. The host must integrate the installed tool definitions and callbacks deliberately.
See Installation for the full hosted command list, Tool Definitions for the renderer contract, and AI SDK Integration for additive chat integration recipes.