Stack
A single-axis layout that wraps when the task calls for it.
Live — this one is real
Usage
import { Stack, Badge } from "mizu-ui";
export function Example() {
return (
<Stack direction="row" wrap gap={12}>
<Badge>React</Badge>
<Badge>TypeScript</Badge>
<Badge>Native CSS</Badge>
</Stack>
);
}
Source & setup
Add this component to your project with the shadcn CLI. The command copies its source into your configured UI directory, with base.css, Mizu’s tokens, and the stylesheets that hold its rules. Each rule lives in one stylesheet, so components you add together never repeat CSS. In a project without a components.json, run npx shadcn@latest init 0xuser64bit/mizu/preset first: plain init installs shadcn’s theme into your global CSS. Then load the fonts.
npx shadcn@latest add 0xuser64bit/mizu/stack 0xuser64bit/mizu/badgeThe example also uses Badge, so the command adds it too.
Every component imports from its own path, its name in kebab case. Its source, layout/Layout.tsx, also holds Grid, AspectRatio, ScrollArea and AppShell. Each has its own command and path; adding one after this copies only its small entry file. To paste the example, replace its mizu-ui import with:
import { Stack } from "@/components/ui/mizu/stack";
import { Badge } from "@/components/ui/mizu/badge";For npm imports, import mizu-ui/styles.css once. Fonts are optional via mizu-ui/fonts.css. Override --mizu-* tokens or use className for local styling. Uses native React and CSS; install the package peers for root imports. A Server Component: it renders on the server, with no client JavaScript of its own.
Inspect layout/Layout.tsx
Source is included in the npm package under src/layout/Layout.tsx.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| direction | "row" | "column" | "column" | Main axis. |
| gap / align / wrap | number / CSS alignItems / boolean | — | Spacing, cross-axis alignment and wrapping. |
| ...props | HTMLAttributes | — | Native div props; style can override defaults. |
Accessibility
No synthetic semantics. Use children with meaningful document structure.
Motion
Native flex layout.