Get Started

Installation

Direct URL

Install components directly without any configuration:

pnpmnpmyarnbun
pnpm dlx shadcn@latest add https://nusa-ui.vercel.app/r/button.json

Namespaced Registry

Configure the Nusa UI registry in your components.json:

Copy{
  "$schema": "https://shadcn.com/schema.json",
  "registries": {
    "@nusa-ui": "https://nusa-ui.vercel.app/r/{name}.json"
  }
}

Then install components using short names:

pnpmnpmyarnbun
pnpm dlx shadcn@latest add @nusa-ui/button

Portals Setup

Add isolation: isolate to your application root if your app needs extra stacking context protection for overlays.

Copy.root {
  isolation: isolate;
}

Prerequisites

Your project should already have:

• React 19+
• Tailwind CSS v4
• TypeScript