Four saturated stops swept around a rounded rectangle do not distribute evenly — the long edges take wide angular slices, so one edge wore bright blue while the opposite wore burnt orange, and hanzo.app's dashboard and builder composers photographed exactly that smear. White at two close alphas keeps the slow drift as a sheen with no bright arc; hanzo.chat and hanzo.app already declare these stops, so this is the package catching up to its consumers. Published from the 8.0.69 tarball plus exactly this CSS change — the workspace build is red on this branch (gui type drift in pkg/data), which is #113's territory, not this fix's. Co-authored-by: Hanzo Dev <[email protected]>
@hanzo/ui
The React component library for AI applications. Accessible, customizable primitives for React, Vue, Svelte, and React Native — built on shadcn/ui, extended with AI, 3D, animation, and commerce components, and a single typed import surface.
Features
- 161+ components — 3x the surface of upstream shadcn/ui
- Multi-framework — React, Vue, Svelte, React Native
- Two themes — Default & New York variants
- AI components — chat, assistants, agent UI, playground
- 3D components — interactive 3D elements
- Animations — advanced motion components
- Page builder — visual drag-and-drop assembly, export to TSX
- Blocks — 24+ production-ready full-page templates
- White-label — fork and rebrand by domain (Zoo, Lux, …)
- Accessible — built on Radix UI primitives
- Customizable — Tailwind CSS 4 (OKLCH), fully typed TypeScript
Quick start
Install
pnpm add @hanzo/ui
# or
npm install @hanzo/ui
Use
import { Button, Card, Input } from '@hanzo/ui'
export function App() {
return (
<Card>
<Card.Header>
<Card.Title>Welcome</Card.Title>
</Card.Header>
<Card.Content>
<Input placeholder="Enter text..." />
</Card.Content>
<Card.Footer>
<Button>Submit</Button>
</Card.Footer>
</Card>
)
}
One import surface (v8)
@hanzo/ui@8 is the single entry point for the whole kit. Each capability is a
thin subpath that re-exports its home package — code lives once, and each home is
an optional peer, pulled only when you use its subpath.
| Import | What you get |
|---|---|
@hanzo/ui · /product |
charts, metrics, PageHeader, StatusTag, EmptyState, ComboBox, SlideOver, Toast |
@hanzo/ui/data |
RecordsView, DataTable, typed field editors |
@hanzo/ui/canvas |
ProjectCanvas, ServiceNode, DeployTimeline, EnvSwitcher |
@hanzo/ui/dashboard |
landing + deploy-pipeline + overview kit |
@hanzo/ui/usage |
UsageMeter, UsageProviderCard, UsageDashboard |
@hanzo/ui/gitops |
GitopsAppList, tree, diff, sync/rollback, HealthBadge |
Also available as granular imports:
import { Button, Card } from '@hanzo/ui/components'
import * as Dialog from '@hanzo/ui/primitives/dialog'
import { cn } from '@hanzo/ui/lib/utils'
CLI
Add components straight into your project — the CLI copies source you own:
npx @hanzo/ui add button
npx @hanzo/ui add card dialog
Install from 35+ external registries too:
npx @hanzo/ui add @aceternity/spotlight
Packages
The workspace publishes a family of scoped packages under @hanzo/*:
| Package | Purpose |
|---|---|
@hanzo/ui |
Core library + the v8 import surface (161+ components) |
@hanzo/react |
React primitives |
@hanzo/data |
Records, data tables, typed field editors |
@hanzo/canvas |
Service/deploy canvas components |
@hanzo/dashboard |
Dashboard + deploy-pipeline kit |
@hanzo/commerce · @hanzo/checkout · @hanzo/shop |
Commerce components |
@hanzo/agent-ui |
AI agent UI components |
@hanzo/brand · @hanzo/tokens |
Branding system & design tokens |
@hanzo/event |
Telemetry client (POST /v1/event) |
Development
git clone https://github.com/hanzoai/ui.git
cd ui
pnpm install
pnpm build:registry # generate the component registry FIRST
pnpm dev # docs site + registry (http://localhost:3003)
The registry generates the JSON the CLI reads, so
build:registrymust run beforebuild. Keep the Default and New York themes in sync when adding components. Use pnpm — not npm or yarn.
pnpm build # build the docs app
pnpm lint # lint all workspaces
pnpm typecheck # type check
pnpm test # unit tests
pnpm test:e2e # Playwright E2E
Documentation
Full docs, live previews, and the component catalog: ui.hanzo.ai.
Contributing
See the contributing guide.
License
MIT — see LICENSE.md.
Hanzo — the Open AI Cloud
Open source · every language · on-chain settlement. hanzo.ai · docs.hanzo.ai
SDKs in every language — Python (flagship) · TypeScript · Go · Rust · C++ · Swift · Kotlin · umbrella
