インストール
パッケージを入れ、ルートをマウントし、バンドラーに一つだけ伝える。
セットアップは、どのホストでも同じです。違うのはバンドラーの設定をどこへ書くかだけで、ホストごとにページがあります。
インストール
pnpm add @hanzo/ui @hanzo/guireact と react-dom は、19 以降の peer です。@hanzo/gui を peer にしているのは意図です。これは React のコンテキストを渡すもので、物理的なコピーが二つあるとコンテキストも二つになり、ルートは一方へ書き、コンポーネントはもう一方を読みます。バージョンは一つに保ち、アプリが宣言します。
ルートをマウントする
import { Hanzo } from '@hanzo/ui'
export default function App({ children }) {
return <Hanzo>{children}</Hanzo>
}アプリがマウントするのは Hanzo だけです。gui の設定を値として持ち、生成されたスタイルシートを読み、テーマを決めます。初期値はダークで、theme="light" で切り替えます。ルートのテーマがないと、どのコンポーネントも例外を投げます。付け忘れると最初の描画で落ち、スタイルのないまま静かに描画されるページにはなりません。
開発中、ルートはスタイルシートが文書に届いたかを確かめ、届いていなければコンソールにそう書きます。そこで名指しされる直し方は、インポート一つ、@hanzo/ui/styles.css です。パッケージ自身のシートを落としたバンドラーのためのものです。
バンドラーに伝える
エンジンの依存グラフは react-native という名前を使い、その中の一つ、アイコンセット配下の react-native-svg は、ネイティブのエントリと .web.js の兄弟を一緒に出荷します。Web のビルドでネイティブ側を拾うと、依存の中の Flow のソースを解析できずに落ちます。壊れたパッケージのように見えて、足りない設定には見えません。それを防ぐ設定は二つです。
react-nativeはreact-native-webに解決する。.web.jsが.jsより優先される。
Next では、この二つはラッパー一つ、@hanzo/ui/next です。Vite では resolve の二行です。One では、フレームワークがすでに両方をやります。Expo では設定するものがありません。Metro は react-native をネイティブに話すからです。
何か描いてみる
import { Badge, Button, Card, CardContent, CardHeader, CardTitle, Input, XStack } from '@hanzo/ui'
export function Sample() {
return (
<Card>
<CardHeader>
<CardTitle>Deploy</CardTitle>
</CardHeader>
<CardContent>
<Input placeholder="name" />
<XStack gap="$2" mt="$3">
<Button>Deploy</Button>
<Button variant="outline">Cancel</Button>
<Badge variant="secondary">preview</Badge>
</XStack>
</CardContent>
</Card>
)
}フォント
パッケージは Zen と Zen Mono を同梱し、--font-sans と --font-mono に結んでいます。何も結ばないホストは、手間なしでその書体を得ます。自分の書体を持つホストは --font-sans-provided を置けば、それが勝ります。タイポグラフィ を見てください。