@zui.react/zui

v0.8.12

Published

10 days ago

A modern React component library focused on speed, polish, and motion. 22 components, 6 motion effects, 27 production patterns (5 base, 7 AI-native, 12 3D / scene, content generator) plus 26 inline brand & AI-IDE icons. Premium purple gradient theme. Ship

Downloads

4,220

npm install @zui.react/zui

Quick start

import '@zui.react/zui/styles.css';
import { Button, Dialog, Card, Marquee, BorderBeam } from '@zui.react/zui';

export default function App() {
  return (
    <Card variant="elevated">
      <Card.Header>
        <Card.Title>Hello, world.</Card.Title>
        <Card.Description>You're shipping with ZUI.</Card.Description>
      </Card.Header>
      <Card.Footer>
        <Button>Get started</Button>
      </Card.Footer>
    </Card>
  );
}

Add a theme class to your <html>:

<html class="theme-dark">     <!-- premium purple gradient surface (default) -->
<html class="theme-clean">    <!-- light surface -->
<html class="theme-luminous"> <!-- branded marketing -->

Theme switching is a single class swap — no React re-renders, no FOUC.

Use with any AI coding agent

@zui.react/mcp is a drop-in MCP server that exposes the whole ZUI catalog to Claude Code, Cursor, Windsurf, Continue, Zed, GitHub Copilot, and Antigravity.

# Claude Code
claude mcp add zui -- npx -y @zui.react/mcp

Then ask the agent: "Add a Button", "scaffold a pricing page in dark theme", "show me the design tokens". The server returns a file diff your editor applies — no hallucinated prop names, no stale import paths.

14 tools, 12 resources, 6 slash commands. Full reference: zui docs → MCP.

What's inside

Components (27)

Foundations — Button · Input · Label · Textarea · Separator · Skeleton · Badge · Avatar Overlays — Popover · Tooltip · DropdownMenu · HoverCard Modals — Dialog · AlertDialog · Sheet · Toast Forms — Checkbox · RadioGroup · Switch · Select · SegmentedControl Composition — Card · Tabs · Accordion · Progress · Slider · Sidebar

Motion effects (6)

Marquee — endless scroll, GPU-only transform
BorderBeam — single moving point along a border
ShineBorder — conic-gradient shimmer
NumberTicker — counts up on view via IntersectionObserver
MagicCard — cursor-following spotlight
Dock — macOS-style cursor magnification

Production patterns (26)

Base (5) — FilterPanel · ViewingOptionsCard · ProjectDetailCard · SharePanelCard · SignInCard · LoginSplit
AI-native (7) — AIPrompt · AIDropzone · AIRecorder · AIGreeting · AIMessage · AIGenerating
3D / scene (12) — Action3D · Switch3D · ImageCard3D · PlanCard3D · MenuList3D · JobCardStack · TrackDelivery · TravelCard · InstallCard · PricingDark · StatsCard · TalentGrid

Brand & AI-IDE icons (26)

Inline SVGs — Google · Apple · Microsoft · Facebook · X · Github · OpenAI · Anthropic · Zoom · Slack · Framer · Loom · Hopin · Notion · Figma · Cursor · Gemini · Claude · Windsurf · Copilot · Antigravity · Replit · V0 · Bolt · Perplexity · Grok.

Architecture

Tokens are the API. Every color, space, radius, and duration is a CSS variable. Theming is one class swap.
Behavior on Radix. Focus traps, keyboard nav, and ARIA inherit from @radix-ui/react-* — we don't reinvent a11y.
Motion is data-state driven. data-state="open|closed" on every overlay; CSS animates from there. No JS animation library.
Performance first. Animations only target transform + opacity. will-change is scoped to elements about to move, never global.
Composition over configuration. Compound APIs (<Dialog.Trigger>, <Sidebar.Menu>, <Card.Header>) over giant prop bags.

Stack

React 18+ peer dep
Tailwind CSS v4 utilities (bundled — no setup needed)
Radix UI primitives
Floating UI (positioning)
Lucide icons (peer dep, already used everywhere)
class-variance-authority (variant API)

Bundle

dist-lib/index.js — 272 KB, 52 KB gzipped
dist-lib/styles.css — 226 KB, 34 KB gzipped (tokens + utilities + keyframes + component CSS, all in)
Single index.d.ts entry, full TypeScript autocomplete

License

MIT — same for @zui.react/zui and @zui.react/mcp.