vamsiy78/ballmac-ui

Accessible React + Tailwind v4 components, blocks and templates in one design language. You add what you need with the
shadcn CLI and the source lands in your project, ready to read and change. Your AI coding agent can search and
install them too, through MCP. Now listed in the official shadcn registry directory.
**Site and docs: ui.ballmac.com**
What is in it
- **240+ components:** primitives, forms, data display, navigation, feedback, motion, backgrounds, text effects, AI interfaces, developer
tools, device frames and desktop-style surfaces.
- **60+ blocks and 17 templates:** heroes, pricing, dashboards, sign-in, settings and more, composed from the components.
- **12 themes** with a live builder, light and dark. Motion is part of the theme: speed, bounce, travel, hover and stagger, five ready-made feels, and a reduced-motion fallback. Data and form blocks show loading, empty, error, submitting and success through one state prop. Platform feels make every component handle like macOS, iOS or Windows, with window chrome for Tauri and Electron apps.
- **Built to a standard:** every item has examples, keyboard support, reduced-motion handling, right-to-left support and one translation
provider for its built-in text. See AUTHORING.md.
- **Made for AI agents:** each item carries a description, when to use it and when not to, what it composes with, and keyboard notes. Available
through llms.txt, a JSON API and the @ballmac/mcp server.
- **No collisions:** everything installs into components/ballmac/, so it never overwrites your shadcn/ui files.
- **Verified installs:** the release check installs every item into a fresh Next.js app, then type-checks and builds it.
Quick start
You need a project with React 19, Tailwind CSS v4 and shadcn set up (npx shadcn@latest init; it creates components.json). Both the Base UI and
Radix styles work.
@ballmac is in the official shadcn registry directory, so there is no registry to configure. On an older CLI, or to pin the address, run npx shadcn@latest registry add "@ballmac=https://ui.ballmac.com/r/{name}.json" once, or install by URL: npx shadcn@latest add https://ui.ballmac.com/r/button.json. Browse and preview everything at
ui.ballmac.com/components, and see the installation guide for
the optional Ballmac theme.
Use it with an AI agent
The server is read-only and needs no account. It searches the catalog, returns props, keyboard behaviour and source, gives the exact install
command, and can plan a whole page from blocks. Setup for Cursor, VS Code, Windsurf, Codex and Claude Desktop is in the
MCP docs and in packages/mcp. The official shadcn MCP server also works with this registry.
Free and Pro
| | Free (this repository) | Pro |
| --- | --- | --- |
| Components, blocks, templates, themes | All of them, MIT licensed | Everything in Free |
| Premium blocks | | 150 more: heroes, features, pricing, dashboards, app screens, ecommerce, content and more |
| Starter apps | | Beacon SaaS (teams, Stripe billing, dashboard), Quire (an AI assistant that cites its sources) and Cove (a Tauri desktop app that looks native on macOS and Windows) |
| Design tokens | | Figma tokens for every theme |
| How you get it | shadcn add @ballmac/... | A private registry (@ballmac-pro) with a licence key, or log in on the site to copy code and download the starters |