@hanzo/ui

Einführung

Eine Komponentenbibliothek für Web, Native und Desktop, auf einem einzigen Unterbau. Ein Import, eine Wurzel, und nichts einzurichten.

@hanzo/ui ist die Komponentenbibliothek von Hanzo. Jede Komponente zeichnet über @hanzo/gui, eine Style-Engine für React und React Native, die Styles als Props entgegennimmt und sie auf dem Web zu atomarem CSS kompiliert. Weil die Engine plattformübergreifend ist, gilt das auch für die Bibliothek: derselbe Switch wird im Browser zu einem div und auf dem Telefon zu einer nativen View.

Einen Build aus Utility-Klassen gibt es hier nicht. Kein Tailwind, kein PostCSS-Plugin, kein Radix-Primitiv unter einer Komponente, keine Registry, kein components.json und keine CLI, die Quelltext in dein Repository kopiert. Du installierst ein Paket und importierst daraus.

Installieren und rendern

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

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

Das ist die ganze Einrichtung. Hanzo ist die Wurzel, und sie trägt drei Dinge, die früher jede App selbst erledigen musste: die Gui-Konfiguration, gegen die sich die Tokens auflösen, das Stylesheet und das Theme. Es gibt kein CSS zu importieren und keinen Generator zu starten — das Stylesheet entsteht bei der Veröffentlichung des Pakets, indem jede Komponente gerendert und das CSS eingesammelt wird, das dieser Render erzeugt. Der erste Paint und jedes Server-Rendering haben ihre Regeln also schon.

Das Einzige, was ein Host noch tut, ist seinem Bundler zu sagen, dass react-native react-native-web bedeutet. Das ist ein Alias, und jede Host-Seite unter Installation zeigt, wohin er gehört.

Gestylt wird über Props

Ein Style ist eine Prop der Komponente, und ein responsiver Style ist dieselbe Prop unter einem Breakpoint-Schlüssel.

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>

Breakpoints sind Mindestbreiten, mobile-first: $sm 640, $md 768, $lg 1024, $xl 1280. Ein Wert, der mit $ beginnt, ist ein Token — eine Farbe, eine Größe, eine Stufe der Abstandsrampe — und löst sich gegen das Theme auf, sodass $background im Hellen und im Dunklen eine andere Farbe ist, ohne dass die Aufrufstelle das weiß. Die Schriftgröße ist immer ein Token, nie eine Zahl: fontSize="$3", nicht fontSize={14}. Eine Person kann ihre eigene Schriftskala setzen, und die Rampe, die $n liest, wandert mit; eine fest eingeschriebene 14 kann das nicht. Themes hat die Leitern.

Layout

Stacks sind Flex. XStack legt in einer Zeile aus, YStack in einer Spalte, und beide nehmen gap, items und justify. Ein Grid ist ein echtes CSS-Grid, unter @hanzo/ui/grid, dessen Spuren vom Container kommen und nicht von den Kindern — siehe Raster.

Was wo liegt

ImportWas es ist
@hanzo/uiDie Komponenten-API — jedes Primitiv, die Stacks, die Schriftskala und Hanzo.
@hanzo/ui/productDie App-Schicht: Diagramme, das Chrom der Seite, Statusmarken, Detailbereiche, der Theme-Schalter.
@hanzo/ui/blocksInhalt als Daten, und die Renderer, die ihn zeichnen.
@hanzo/ui/gridGrid und Cell, nur Web.
@hanzo/ui/product/pureDie Regeln, auf denen die Produktschicht läuft, ohne angehängte Komponente.
@hanzo/ui/csssubstitute, für Tests, die ein DOM ohne Kaskade nicht beantworten kann.
@hanzo/ui/nextDer Next-Wrapper, der die Web-Aliase für beide Bundler setzt.

Die Katalogseiten dieser Site — Komponenten, Blöcke, Produkt — werden aus dem Paket selbst gelesen: jede rendert die Beispiele eines Moduls neben ihrem Quelltext und zitiert seine Typen.

Fragen

Brauche ich Tailwind? Nein. Komponenten nehmen Style-Props, und die Identität sind schlichte benutzerdefinierte CSS-Eigenschaften. Kommt eine App mit Klassen-Strings an, lesen Box, sx und css sie über tw und machen daraus dieselben Props; nichts erreicht das DOM als Klasse, die das Paket nicht definiert hat.

Ist das Kopieren und Einfügen? Nein. Installiere das Paket und importiere daraus. Die Komponenten werden mit dem Paket versioniert, und die Export-Map ist das, worüber ein Subpath auflöst, sodass ein tiefer Import über Patches hinweg weiter funktioniert.

Welche Frameworks? Jeder React-19-Renderer, sobald der Bundler den Alias react-native kennt. Es gibt Seiten für Vite, Next, One, Expo und Tauri.

Kann ich es kommerziell nutzen? Ja. Apache-2.0 oder MIT, nach deiner Wahl.