Registry
How the diarmuradi registry works with the shadcn CLI.
diarmuradi is a shadcn registry. The shadcn CLI fetches blocks as JSON, resolves dependencies, and writes files directly into your project. No packages to install, no version conflicts.
How it works
When you run shadcn add @diarmuradi/header-1, the CLI:
- Reads
@diarmuradifrom theregistriesfield in yourcomponents.json - Replaces
{style}with your current style and{name}withheader-1 - Fetches the registry item JSON from the resolved URL
- Resolves all
registryDependenciesrecursively - Writes components, hooks, utils, and CSS into your project
Registry URL
The public registry URL uses two placeholders:
{
"registries": {
"@diarmuradi": "https://diarmuradi.com/r/{style}/{name}.json"
}
}{style}is replaced with your project's style fromcomponents.json(e.g.base-nova){name}is replaced with the block name (e.g.header-1)
So @diarmuradi/header-1 with style base-nova resolves to:
https://diarmuradi.com/r/base-nova/header-1.json
You can omit the style segment (/r/{name}.json). The registry defaults to base-nova.
Namespaces
diarmuradi uses the shadcn namespace system. Namespaces let you install from multiple registries in the same project:
{
"registries": {
"@diarmuradi": "https://diarmuradi.com/r/{style}/{name}.json",
"@diarmuradi-pro": {
"url": "https://diarmuradi.com/api/registry/bearer/{name}",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}Paid blocks require a Core or Full Access plan. Generate a key from your account after signing in.
Dependency resolution
Blocks can depend on other registry items. When you install a block, the CLI automatically resolves and installs all dependencies: UI primitives, hooks, and shared utilities.
Styles and bases
Blocks ship for Base UI (default), Radix UI, and React Aria. Styles combine a base and a visual preset, for example:
base-nova,base-vega,base-maiaradix-nova,radix-vega,radix-maiaaria-nova,aria-vega,aria-maia
Match the style in components.json to the base you initialized with shadcn.
Templates
Application templates (like Lusmu) are not registry items. After purchase, download the .zip or clone the private repo from the template page. Full Access unlocks every premium template.