Installation

NiceUI is not a package. You copy components into your project — by hand or with the shadcn CLI — and own the code from there.

Set up Tailwind CSS

NiceUI components are styled with Tailwind CSS v3 or v4. Any React framework works — Next.js, Vite, Remix or Astro.

$ npm install tailwindcss

Initialise shadcn (optional)

If you have not used the shadcn CLI in this project yet, run the init command once. It configures the components path alias.

$ npx shadcn@latest init

Add a component

Every component page shows its install command. The CLI downloads the source straight into your project.

$ npx shadcn@latest add https://niceui.dev/r/button.json

Make it yours

The code now lives in your repo. Edit anything — there is no package to update and no lock-in.

Fonts used in previews

Previews use Geist and Instrument Serif (for italic accents via Tailwind's font-serif). Add them through next/font or Google Fonts, or swap in your own.

For AI assistants

Point your assistant at /llms.txt for an index, or /llms-full.txt for every component's full source in one file. The registry index lives at /r/registry.json.