Kuzenbo Core Components
Use this skill for external app code that consumes the stable public package @kuzenbo/core@0.0.6 .
Runtime Setup
- Install runtime dependencies:
npm install @kuzenbo/core @kuzenbo/theme
- Load one theme stylesheet once at app root:
import "@kuzenbo/theme/prebuilt/kuzenbo.css";
- Add theme runtime wiring:
import { ThemeBootstrapScript, ThemeProvider } from "@kuzenbo/theme";
<ThemeBootstrapScript /> <ThemeProvider>{children}</ThemeProvider>
- Add KuzenboProvider only when global component defaults or env flags are needed.
Canonical Imports
-
Components: @kuzenbo/core/ui/<component>
-
Provider/runtime helpers: @kuzenbo/core/provider
-
Size helpers: @kuzenbo/core/size
Implementation Workflow
-
Read references/component-exports.md and choose the smallest public component that satisfies the request.
-
Start with default component behavior and customize through className before introducing new variants.
-
Keep size values canonical: xs | sm | md | lg | xl .
-
Prefer compositional primitives (Dialog , Popover , DropdownMenu , Sidebar , Tabs ) before custom wrappers.
Guardrails
-
Stay on the public stable surface listed in references/component-exports.md .
-
Never import from package internals (src/* , dist/* , deep private files).
-
Keep @kuzenbo/theme paired with @kuzenbo/core at runtime.
-
If a requested component is not exported, state that clearly and compose from existing primitives.
References
-
references/component-exports.md
-
references/provider-and-size.md