CLI

Initialize your project

Sets up the cn utility, path aliases, and theme variables. Run this once before adding components to an existing Astro project.

Projects created with create-bearnie already include a bearnie.json config at the project root and can skip init.

Pick a theme

During init (and create-bearnie) you choose two things, both from Tailwind’s official palette:

• Base color — the grays used for backgrounds, text, and borders: neutral, slate, gray, zinc, stone, mauve, olive, mist, or taupe
• Accent color — the primary used for buttons, focus rings, and active states: a neutral default or any Tailwind color (red, rose, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink)

Your choice is saved as a single theme name in bearnie.json — blue, slate, slate-blue, and so on. Every combination installs the same bearnie.css file, so all components work with all themes.

Switch anytime:

Switching updates bearnie.json, so diff and update keep comparing against the palette you actually use.

Keep components up to date

Components are copied into your project, so they don’t change until you say so. See what differs from the registry:

Prints a colored per-file diff for every installed component that drifted — whether from your own edits or from registry improvements. Use --name-only for a compact summary, or pass component names to check just those.

Pull the latest registry versions:

Shows what will change, warns when you have local edits, and asks before writing. Any new npm dependencies are installed with your package manager. Use --yes to skip the confirmation.

Add components

Add multiple components at once:

Add everything:

Components are copied to src/components/bearnie/. Required utilities go to src/utils/.

Interactive components (like popover, command, and combobox) also install shared runtime files in src/utils/runtime/ automatically. No additional loader setup is required.

You own the code.

Barrel export

After adding components, install the barrel for named imports from @/components/bearnie:

---
import { Button, Card } from "@/components/bearnie";
---

The barrel re-exports all installed components. Add it last, once the components you need are in place. Projects created with create-bearnie --full include it automatically.

List available components

Shows all components grouped by category, including Theme (styles) and Meta (barrel). Use --json for machine-readable output.

Options