Add Opalus UI

Opalus UI uses the shadcn registry format and supports projects configured with either Base UI or Radix.

1. Initialize shadcn

Choose your preferred component base when creating components.json:

pnpm dlx shadcn@latest init --base base

Use --base radix instead if your project uses Radix. Opalus UI resolves the matching shadcn dependencies automatically.

2. Add the registry

Add the production registry to components.json:

{
  "registries": {
    "@opalus-ui": "https://opalus-ui.aquamarinez.com/r/{name}.json"
  }
}

3. Install a component

The install command is the same for Base UI and Radix projects:

pnpmnpxyarnbun

bash

pnpm dlx shadcn@latest add @opalus-ui/surfaceCopy