Zi UI v3 · April 2026

The foundations and surface
behind every Zi UI product.

A token-first design system authored in OKLCH. 6 foundations and 18 components, rebuilt from the @ziui/v3 upstream release. Every page here pulls from the same tokens.css you'd ship.

Foundations6Color · Type · Radius · Spacing · Elevation · Motion
Components18Primitives, form, feedback, layout
Color tokens24Surface, accent, status, soft
Themes2Light · Dark · shared tokens
Skill IntroductionSkill 介绍

A design system as a skill, inspired by Claude Design.

以 Skill 形态分发的设计系统——灵感来自 Claude Design。

Where this came from

它从哪来

On April 17, 2026, Anthropic launched Claude Design — an AI tool that reads your codebase and brand, and generates a full design system as a browseable folder. No TSX. No framework. Just tokens.css, components.css, and a set of HTML proof pages.

2026 年 4 月 17 日,Anthropic 发布了 Claude Design——一个读你 codebase 和品牌资料、反向生成完整设计系统的 AI 工具。输出是一个可浏览的文件夹:没有 TSX、没有框架,就是 tokens.css、components.css,加一组 HTML 证明页。

Staring at that folder, one thing became obvious: the "design system" a Claude Design project ships is not a React component library. It's a pure-CSS truth source with a documentation site wrapped around it. This repo packages that idea as a reusable, distributable agent skill.

盯着那份文件夹看,有一件事忽然清楚:Claude Design 输出的"设计系统"不是一个 React 组件库,而是一份纯 CSS 真相源加一个包裹它的文档站。这个仓库把这个想法打包成了可复用、可分发的 agent skill。

The architecture in one sentence

一句话讲架构

One truth source, many downstream consumers.

一份真相源,多个下游消费者。

The DNA is assets/tokens.css, organized into two layers: primitives (--palette-blue-500, physical values) and semantics (--color-accent, meaning). Components only consume the semantic layer — never the palette. components.css projects semantic tokens into classes. Everything else is a downstream consumer.

DNA 是 assets/tokens.css,分为两层:primitive(--palette-blue-500,物理值)和 semantic(--color-accent,语义意义)。组件只消费 semantic 层——永远不直接引用 palette。components.css 把 semantic token 投影成类。仓库里其他一切都是下游消费者。

Three orthogonal axes (data-brand, data-theme, data-contrast) compose freely on <html>. Swap the semantic map to rebrand without touching a component; enable high-contrast for WCAG AAA; stack dark mode on top. That's not a convenience — it's the architecture itself.

三个正交轴(data-brand、data-theme、data-contrast)在 <html> 上自由组合。改 semantic 层换品牌而不动组件;开高对比度过 WCAG AAA;叠上 dark mode。这不是"便利"——这就是架构本身。

01
AI reads CSS best
AI 最擅长读 CSS
Semantic HTML + CSS variables are the densest, least-ambiguous language in Claude's training data. No cva() indirection to unwind.
语义 HTML + CSS 变量是 Claude 训练语料里最稠密、最无歧义的语言。没有 cva() 这层中介要 AI 翻译。
02
Framework independence
框架独立
Two CSS files work with React, Vue, Svelte, Astro, plain HTML, even email templates. TSX locks you to one runtime.
两个 CSS 文件可以用在 React、Vue、Svelte、Astro、纯 HTML,甚至邮件模板里。TSX 把你锁死在一个 runtime。
03
Designers can read it
设计师读得懂
Open tokens.css, see every decision. No Storybook build, no TypeScript to parse. Visual proofs live as browseable HTML.
打开 tokens.css 就能看所有决策。不用跑 Storybook、不用解析 TypeScript。视觉证明就是可浏览的 HTML。
04
Restraint by design
刻意克制
No runtime JS, no ZiProvider, no npm dependency graph. The less the skill ships, the more places it fits.
没有 runtime JS,没有 ZiProvider,没有 npm 依赖图。skill 装得越少,它能去的地方就越多。
05
Outlives frameworks
比框架活得久
Three years from now, React 19 may be legacy. Your tokens.css still runs. CSS and HTML are the Web's bedrock.
三年后 React 19 可能已成遗产,你的 tokens.css 照样跑。CSS 和 HTML 是 Web 的基岩。

Foundations

/foundations

Components

/components · 18