mirror of
https://github.com/hanzoai/ui.git
synced 2026-11-20 20:07:34 +00:00
main
Releases #327 (the Effort and Mode lists open where they can be seen, hanzo-inc/app#444) and holds the row's titles in place (hanzo-inc/app#313). The closed words already read as their title over (or beside, on a phone) their value since 8.33.5: "Model Opus 5.5", "Effort Auto", "Mode Manual". Nothing held that. test:composer now requires each one's visible text to start with its title and end with its value, at every width and theme, in Chat and in Dev; with the titles taken out it fails 24 times. Tune.test.tsx says the same in jsdom. test:composer also opens the Model picker, beside Effort and Mode: a panel seen on screen, beside its word on a laptop, and put away by Escape. Part of hanzo-inc/app#444 Part of hanzo-inc/app#313 Co-Authored-By: Claude Opus 5.5 <[email protected]>
@hanzo/ui
The React component library for AI applications. 157 components on one substrate, so the same import runs on web, native and desktop.
One substrate
Every component renders through @hanzo/gui
primitives on the @hanzo/tokens scale. No Radix, no Tailwind, no utility
classes — style props and $ tokens, which is what lets one import serve React,
React Native (Expo) and Tauri.
Other frameworks are their own packages, because a theme does not port:
@hanzo/svelte for Svelte 5.
Quick start
pnpm add @hanzo/ui
import { Hanzo, Button, Card, CardHeader, CardTitle, CardContent, Input } from '@hanzo/ui'
export function App() {
return (
<Hanzo>
<Card>
<CardHeader><CardTitle>Welcome</CardTitle></CardHeader>
<CardContent>
<Input placeholder="Enter text…" />
<Button>Submit</Button>
</CardContent>
</Card>
</Hanzo>
)
}
<Hanzo> is the whole setup — it carries the gui config, the theme and the
stylesheet. There is no CSS import and no generator step.
Import surface
| Import | What you get |
|---|---|
@hanzo/ui |
the component surface — Button, Card*, Dialog*, Input, Select*, Tabs*, Popover*, Command*, … |
@hanzo/ui/product |
charts, metrics, PageHeader, StatusTag, EmptyState, ComboBox, SlideOver, Toast |
@hanzo/ui/chat |
Thread, Message, Composer, Sidebar, Header, Code, Sources |
@hanzo/ui/chat/pure |
sends, ready, pinned — decisions with no React, loads in Node |
@hanzo/ui/models |
ModelPicker, parseModels, fetchModelCatalog, defaultModel |
@hanzo/ui/data |
RecordsView, DataTable, typed field editors |
@hanzo/ui/core · /tokens |
cn, font vars, the colour/theme/radii/spacing scale |
@hanzo/ui/theme.css · /styles.css |
tokens alone, or the complete sheet |
@hanzo/ui/primitives/<Name> |
one member, for hosts that modularize imports |
@hanzo/ui/{canvas,dashboard,usage,gitops} |
optional-peer kits |
CLI
npx @hanzo/ui add button
npx @hanzo/ui add @aceternity/spotlight # 35+ external registries
Packages
| Package | Purpose |
|---|---|
@hanzo/ui |
the component library |
@hanzo/svelte |
the Svelte 5 kit |
@hanzo/react |
React primitives |
@hanzo/data |
records, data tables, typed field editors |
@hanzo/canvas · @hanzo/dashboard |
service/deploy canvas, dashboard kit |
@hanzo/commerce · @hanzo/checkout · @hanzo/shop |
commerce |
@hanzo/brand · @hanzo/tokens |
branding and design tokens |
@hanzo/event |
telemetry client (POST /v1/event) |
Development
pnpm install
pnpm --filter @hanzo/ui... build # the `...` builds workspace deps first
| Command | |
|---|---|
pnpm --filter @hanzo/ui test:unit |
styles + render surface |
pnpm --filter @hanzo/ui test:consumer |
packs the tarball, installs it outside the repo, asserts computed styles |
pnpm typecheck · pnpm lint |
The shadcn CLI, the component registry and the docs sites live in
hanzoai/shadcn.
Docs at ui.hanzo.ai. Licensed Apache-2.0 OR MIT, at your option.
Languages
TypeScript
84.3%
MDX
11.7%
JavaScript
2.2%
HTML
0.9%
CSS
0.8%