Skip to content
bejamas/ui
Theme Editor
⌘E
Background
L 0.5
C 0.2
H 250
Foreground
L 0.5
C 0.2
H 250
Primary
L 0.5
C 0.2
H 250
Primary FG
L 0.5
C 0.2
H 250
Secondary
L 0.5
C 0.2
H 250
Secondary FG
L 0.5
C 0.2
H 250
Accent
L 0.5
C 0.2
H 250
Accent FG
L 0.5
C 0.2
H 250
Card
L 0.5
C 0.2
H 250
Card FG
L 0.5
C 0.2
H 250
Popover
L 0.5
C 0.2
H 250
Popover FG
L 0.5
C 0.2
H 250
Muted
L 0.5
C 0.2
H 250
Muted FG
L 0.5
C 0.2
H 250
Border
L 0.5
C 0.2
H 250
Input
L 0.5
C 0.2
H 250
Ring
L 0.5
C 0.2
H 250
Destructive
L 0.5
C 0.2
H 250
Destructive FG
L 0.5
C 0.2
H 250
Chart 1
L 0.5
C 0.2
H 250
Chart 2
L 0.5
C 0.2
H 250
Chart 3
L 0.5
C 0.2
H 250
Chart 4
L 0.5
C 0.2
H 250
Chart 5
L 0.5
C 0.2
H 250

Reset

CLI

Astro-first wrapper around shadcn for init/add and docs generation.

The bejamas CLI is a thin Astro-first wrapper over shadcn. Use it for:

  • init: scaffold Astro (single app or monorepo).
  • add: install from registries with short names.
  • docs:build: generate MDX docs from .astro comments.
  • docs:check: validate documentation completeness for components.

For advanced registry browsing, use the shadcn CLI (view, search, list, build).

Install

Section titled “Install”

Use directly via npx:

Terminal window
npx bejamas@latest --help

Commands

Section titled “Commands”

init

Section titled “init”

Create an Astro app or monorepo, wire Tailwind v4, tokens, base styles, and components.json.

Usage

Section titled “Usage”
Terminal window
npx bejamas init [--mode astro|monorepo|monorepo+docs] [--dir .] [--pm pnpm|npm|yarn] [-y]

Sets up Astro project(s) + optional docs workspace (monorepo+docs)

Tailwind v4 + globals

Base tokens & CSS variables

components.json (shadcn schema)

add

Section titled “add ”

Install a component/block from configured registries (see components.json → registries). Writes files under your aliases.

Usage

Section titled “Usage”
Terminal window
npx bejamas add <name>
npx bejamas add @bejamas/pricing-table
npx bejamas add @shadcn/button

Notes

Namespaced form @namespace/name targets a specific registry.

—dry-run shows what would be written.

docs:build

Section titled “docs:build”

Generate MDX docs from comments in .astro files (props/slots/usage).

Usage

Terminal window
npx bejamas docs:build [--in "src/components/**/*.{astro,ts}"] [--out docs/components] [--overwrite] [--dry-run]

Example (in a .astro file)

---
/**
 * Pricing Table
 * @prop plans Plan[] list of plan objects
 * @prop highlight string tier to emphasize
 * @a11y All interactive controls are keyboard reachable
 * @usage Keep headings 1–2 lines; prices use <sup> for currency
 */
---

docs:check

Section titled “docs:check”

Validate documentation completeness for all components. Reports missing required fields, incomplete docs, and provides a summary.

Usage

Section titled “Usage”
Terminal window
npx bejamas docs:check [--cwd <path>] [--json]

Options

Section titled “Options”
  • --cwd <path> - Path to UI working directory
  • --json - Output results as JSON for CI integration

Documentation Fields

Section titled “Documentation Fields”

Required:

  • @component - Component name
  • @title - Display title
  • @description - Short description

Recommended:

  • @preview - Primary visual example
  • @usage - Code usage examples
  • @figmaUrl - Figma design URL

Optional:

  • @examples - Additional examples

Built at Bejamas. The source code is available on GitHub.