Introduction
Ballmac UI is a shadcn registry of accessible React and Tailwind components, blocks and templates that you and your AI agent install as code.
On this page
Ballmac UI is a collection of React and Tailwind CSS components, blocks and templates: desktop-style app surfaces, living backgrounds, text effects, device frames and AI interfaces.
You don't install it as a package. You add the items you need with the shadcn CLI, and the source lands in your project, ready to read and change.
pnpm dlx shadcn@latest add @ballmac/buttonnpx shadcn@latest add @ballmac/buttonyarn dlx shadcn@latest add @ballmac/buttonbun x shadcn@latest add @ballmac/buttonYour AI coding agent can do the same through the Ballmac MCP server (@ballmac/mcp) or the shadcn MCP server.
Find what you need
What makes it different
- Updates that keep your edits. The ballmac CLI merges new versions into your edited copies and installs the tests that ship with components.
- Quality you can check. Every item is loaded in a real browser and the results are public, including failures. ballmac check holds your own app to the same bar.
- Native-app polish. Springs, depth and hairlines from native apps, as app windows, docks, a live notch, menus and notifications that work in any product.
- One design language. Primitives, effects, AI interfaces and developer components share tokens, spacing, focus states and motion curves, and follow your theme in light and dark.
- Effects with manners. Globes, beams and particles pause off-screen, stop for reduced motion and keep your page accessible.
- No collisions. Everything installs into
components/ballmac, so it never overwrites your shadcn/ui files. Dependencies are declared and checked on every build. - Made for AI agents. Every item carries a description, when to use it, when not to, what it composes with and keyboard notes, through MCP and llms.txt.
- Verified installs. Each release installs every item into a fresh Next.js app, then type-checks and builds it.
Free and Pro
Every component, block, template and theme is free and MIT licensed. Ballmac UI Pro adds premium blocks, two complete starter apps and the Figma tokens, delivered through a private registry with a licence key. Set up Pro.
Requirements
- React 19 and Tailwind CSS v4
- A project set up with
shadcn init, which createscomponents.jsonandlib/utils
Stuck, or found a bug? Contact support, or open an issue on GitHub.