How to install dependencies and structure your app.
Note: We use installation process as shadcn/ui.
Initialize shadcn/ui
Run the init command to create a new project with shadcn/ui or setup an existing one.
Add the @soralabs registry
Sora UI is listed in the official shadcn registry index. Register the namespace once in your project:
Add components
Install primitives with the @soralabs scope. Browse the catalog in Primitives or list every item:
Only if the CLI errors — for example unknown registry, cannot resolve
@soralabs, or fetch timeout — add the scope manually to components.json:
For local registry testing (Sora UI repo with bun dev running), use this
instead:
Prefer the production URL when localhost is unavailable.
Built by Axyl. The source code will be available on GitHub soon.
Last updated: 6/10/2026