Docs
Help & FAQ
General library questions live here. For the accordion Q&A building block, see the Faq component.
What is bigbullui?
An open-source React 19 + Tailwind CSS v4 component library with a Ticket-Stub aesthetic: 659 copy-paste components, 75 page blocks, and 1099 hand-drawn stroke icons. MIT licensed, zero runtime dependencies.
How do I install a single component?
Run npx bigbullui add button (any slug works). The file lands in your components/ui with its cn() helper. No install needed at all if you copy the source by hand.
Does it work with shadcn?
Yes. Every component and block is published as registry JSON: npx shadcn@latest add https://ui.bigbullapp.com/r/button.json. Same copy-paste ownership model.
How do I use it with AI coding assistants?
Three ways: the MCP server (claude mcp add bigbullui -- npx -y bigbullui mcp), the agent rules at /skill.md, or per-component markdown at /md/<slug>.
How does dark mode work?
Toggle the dark class on <html>. All tokens switch automatically; every component works in both themes without prop changes.
Is it accessible?
Components ship WAI-ARIA roles, keyboard navigation, visible focus rings, and motion-reduce fallbacks. The docs run automated axe scans in CI.
Is it really zero-dependency?
UI files import only react and a 7-line cn() helper. No Radix, Lucide, Framer Motion, or CVA in component sources — enforced by tests.
How do I theme it?
Override the CSS variables from bigbullui.css (see the Design System page) or copy a ready preset from docs/design.
Does it support RTL?
Yes. Spacing uses logical props (ms-, me-, ps-, pe-, text-start), so layouts flip automatically under dir="rtl".
Can I use just the icons?
Yes: npm i bigbullicons gives you the 1090 icons without components, or pull one with npx bigbullui add icon-ticket.