@hanzo/ui

はじめに

Web、ネイティブ、デスクトップを一つの基盤でまかなうコンポーネントライブラリ。インポートは一つ、ルートは一つ、設定は何もいりません。

@hanzo/ui は Hanzo のコンポーネントライブラリです。どのコンポーネントも @hanzo/gui を通して描きます。React と React Native のためのスタイルエンジンで、スタイルを props として受け取り、Web ではアトミック CSS へコンパイルします。エンジンがクロスプラットフォームなので、ライブラリも同じです。同じ Switch が、ブラウザでは div に、電話ではネイティブのビューになります。

ユーティリティクラスを組み立てるビルドはありません。Tailwind も、PostCSS プラグインも、コンポーネントの下に敷く Radix のプリミティブも、レジストリも、components.json も、ソースをリポジトリへコピーする CLI もありません。パッケージを入れて、そこからインポートします。

インストールして描く

pnpm add @hanzo/ui @hanzo/gui
main.tsx
import { Hanzo, Button } from '@hanzo/ui'

export default function App() {
  return (
    <Hanzo>
      <Button>Ship</Button>
    </Hanzo>
  )
}

セットアップは、これで全部です。Hanzo がルートで、これまで各アプリが自分で持っていた三つを担います。トークンが照らす gui の設定、スタイルシート、テーマです。読み込む CSS はなく、走らせるジェネレーターもありません。シートはパッケージを公開するときに作られます。すべてのコンポーネントを描画し、その描画が出す CSS を拾うので、最初の描画も、サーバー側の描画も、最初からルールを持っています。

ホストがまだやることは一つです。バンドラーに、react-native は react-native-web だと伝えることです。エイリアスは一つで、置き場所は インストール の各ホストのページにあります。

スタイルは props

スタイルはコンポーネントの prop で、レスポンシブなスタイルは、同じ prop をブレークポイントのキーの下に置いたものです。

import { Button, Text, XStack, YStack } from '@hanzo/ui'

<YStack gap="$4" p="$5" $md={{ p: '$8' }}>
  <Text fontSize="$5" color="$color11">
    Balance
  </Text>
  <XStack gap="$2">
    <Button>Send</Button>
    <Button variant="outline">Receive</Button>
  </XStack>
</YStack>

ブレークポイントはモバイルファーストの最小幅です。$sm は 640、$md は 768、$lg は 1024、$xl は 1280。$ で始まる値はトークンです。色、サイズ、間隔ランプの一段で、テーマに対して解決されます。だから $background は、呼び出し側が知らなくても、ライトとダークで別の色になります。フォントサイズは必ずトークンで、数値にはしません。fontSize="$3" であり、fontSize={14} ではありません。人が自分のタイプスケールを決めれば、ランプの $n はそれに合わせて動きます。直書きの 14 は動きません。階段は テーマ にあります。

レイアウト

スタックは flex です。XStack は行、YStack は列に並べ、どちらも gap、items、justify を取ります。グリッドは本物の CSS グリッドで、@hanzo/ui/grid にあります。トラックは子ではなくコンテナが決めます。グリッド を見てください。

どこに何があるか

インポート中身
@hanzo/uiコンポーネント API。プリミティブのすべて、スタック、タイプスケール、そして Hanzo。
@hanzo/ui/productアプリの層。チャート、ページの外装、状態のタグ、詳細ペイン、テーマの切り替え。
@hanzo/ui/blocksデータとしての内容と、それを描くレンダラー。
@hanzo/ui/gridGrid と Cell。Web だけ。
@hanzo/ui/product/pureプロダクト層が従うルール。コンポーネントは付いていません。
@hanzo/ui/csssubstitute。カスケードのない DOM では答えられないテストのため。
@hanzo/ui/next両方のバンドラーへ Web のエイリアスを置く、Next のラッパー。

このサイトのカタログ、コンポーネント、ブロック、プロダクト は、パッケージそのものから読みます。各ページはモジュールの例をソースの横に描き、型を引きます。

質問

Tailwind は要りますか? 要りません。コンポーネントはスタイルの props を受け取り、見た目の実体は素の CSS カスタムプロパティです。クラスの文字列を抱えたアプリが来ても、Box と sx と css が tw を通して読み、同じ props に変えます。パッケージが定義していないクラスとして DOM に届くものはありません。

コピーして貼る方式ですか? 違います。パッケージを入れて、そこからインポートします。コンポーネントはパッケージと一緒にバージョンが付き、サブパスが解決するのはエクスポートマップです。深いインポートは、パッチをまたいでもそのまま動きます。

どのフレームワークですか? バンドラーが react-native のエイリアスを知っていれば、React 19 のレンダラーならどれでもです。Vite、Next、One、Expo、Tauri のページがあります。

商用で使えますか? 使えます。Apache-2.0 か MIT か、好きな方を選んでください。