Installation

Three ways to build with bigbullui: pull components with the CLI, install the all-in-one npm package, or copy source files directly.

Recommended

Method A · CLI (Code you own)

Directly drops zero-dependency component source code into your project.

🎫 CLI v0.2

01 Initialize project & tokens

Creates lib/utils.ts and copies design tokens.

npx bigbullui init

02 Add components

Fetch any component with zero dependencies. Sibling utilities are automatically bundled.

npx bigbullui add button badge ticket-card

03 Use in your views

import { Button } from "@/components/ui/button";
import { TicketCard } from "@/components/ui/ticket-card";

export default function Page() {
  return (
    <TicketCard title="VIP ADMISSION" serial="№ 00481">
      <Button>Claim Pass</Button>
    </TicketCard>
  );
}

Method B · npm package

Single dependency bundling all 460+ components with pre-built ESM/CJS treeshaking.

B · 01 Install the package

npm install bigbullui

B · 02 Add design tokens to globals.css

@import "tailwindcss";
@import "bigbullui/css";

B · 03 Import and use

import { Button } from "bigbullui";

<Button>Admit one</Button>

Method C · Manual copy-paste

Copy the target file from src/components/ui/[name].tsx into your project.
Create ./lib/utils.ts with the 7-line cn helper.
Import bigbullui/css or copy token variables into your stylesheet.