UI

Docs

Installation

Ballmac UI is a shadcn registry. You copy components into your project with the shadcn CLI and own the code. It needs React 19 and Tailwind CSS v4.

1. Set up shadcn (once)

Skip this if your project already has a components.json.

$ pnpm dlx shadcn@latest init

2. Optional: use the Ballmac theme

Every component works with your existing shadcn theme. To match the Ballmac look, add the theme tokens:

$ pnpm dlx shadcn@latest add @ballmac/theme

3. Add components

$ pnpm dlx shadcn@latest add @ballmac/button @ballmac/number-ticker

Files are written to components/ballmac/, and npm dependencies are installed for you.

Before @ballmac is in the shadcn index

Add the registry to components.json, or install by URL:

components.json
{
  "registries": {
    "@ballmac": "https://ui.ballmac.com/r/{name}.json"
  }
}
npx shadcn@latest add https://ui.ballmac.com/r/button.json