Registry Stack App Blocks
Blocks for apps that work with a registry
A shadcn registry of record, request, casework, dashboard and shell blocks for apps that talk to a Registry Stack registry. An app copies a block in and then owns it.
What is here
-
The blocks
Every item installs with the shadcn CLI. The catalogue shows each one with its install line.
-
The runtime package
@registrystack/app-runtimeThe typed browser client and React hooks the blocks use to talk to the app's host. Adding a block installs it.
npm install @registrystack/app-runtime@nextUntil the first stable version, name the next tag. View on npm
-
The gallery
The gallery renders every screen state the blocks can show, for a fictional nursing licence register with synthetic data.
Get started
-
Add the registry
Add it to the app's components.json:
{ "registries": { "@registrystack": "https://ui.registrystack.org/r/0.43/{name}.json" } } -
Add a block
Add an item by name. The CLI copies it and the items it needs into the app, and installs their npm packages.
npx shadcn@latest add @registrystack/<item> -
Own the code
The copied files are now part of the app. Change them as you need. This command shows how the registry's version differs from your copy.
npx shadcn@latest add @registrystack/<item> --diff
What the blocks guarantee
- The registry decides what is allowed. A hidden control, a route parameter or a browser-supplied reference never grants access.
- Blocks call typed routes of the app's own host. The registry protocol and the credentials stay on the server.
- Submission, approval and application are separate steps. A block shows success only after the server confirms.
- A double click or a dropped response never sends a second write: a retry is the same attempt.
- Exact field values and calendar dates are kept as the registry holds them.
- Every default word has a message id. Change or translate the wording by id, without forking a block.
The full App Kit
The blocks are one part of the Registry Stack App Kit, which also has default apps that a registry configures without code.