Chunks UI

React 19.2+ component library built on Base UI + Tailwind CSS v4 + Motion.

Replaces @creation-ui/react. Published as a single npm package — not a copy/paste registry.

Install

bun add chunks-ui motion

Peer dependencies: react and react-dom (^19.2.0), @base-ui/react, class-variance-authority, and optionally tailwindcss (v4) and motion (^12.8.0 || ^14.7.1). See Getting Started for the ranges.

Node 24.22.1 or newer. The install command does not add tailwindcss: the app is expected to have Tailwind v4 set up already.

Usage

Add the theme to the CSS file that imports Tailwind:

@import "tailwindcss";
@import "chunks-ui/theme.css";

Then use the components:

import { Button, Tabs, Input } from 'chunks-ui'

theme.css registers its CSS variables with Tailwind CSS v4 through @theme, and its @source makes Tailwind generate the classes the components use — no plugin needed.

chunks-ui is a client bundle ("use client"). To call cn, cnState or a *Variants function such as buttonVariants in a React Server Component, import it from chunks-ui/utils. It also exports the English label defaults (DEFAULT_*_LABELS) and their <Component>Labels types. See Utilities › Server components.

Motion is optional: without it the components use CSS transitions, and installing motion turns the animations on. See Getting Started.

Components with English text of their own take a labels prop; pass only the keys you change. See Labels.

Popups render into document.body; wrap a subtree in PortalContainerProvider to render them inside an element instead. See Utilities › PortalContainerProvider.

Add the touch-target class to give a small control a 44×44px hit area without changing its size (Utilities › touch-target).

Components

See the component index in the docs.

Stack

Layer	Technology
Headless	@base-ui/react v1.9+ (includes Floating UI)
Styling	Tailwind CSS v4 + CVA
Animation	Motion 12.8+ or 14.7+ (optional peer dep)
Build	tsup (ESM + CJS + .d.ts)
Test	Vitest + Testing Library + jest-axe
Lint/Format	Biome
Package mgr	Bun
Versioning	Changesets

Project Structure

chunks-ui/
  apps/
    docs/                   # Next.js 16 + Nextra 4 docs site
  packages/
    ui/                     # published chunks-ui package
      src/
        components/
          button/
            Button.tsx
            Button.Variants.ts
            Button.spec.tsx
            index.ts
          ...
        lib/
          cn.ts             # clsx + tailwind-merge
          motion.ts         # shared spring presets
          use-motion.ts     # useMotion() + useReducedMotion() hooks
          PopupMotion.tsx   # createPopupRenderer() for Base UI popups
        theme.css           # CSS variables
        index.ts            # barrel export
      tsup.config.ts
      vitest.config.ts
      package.json

Turborepo monorepo with a single publishable package (chunks-ui) and a docs site.

Color System

OKLCH-based semantic tokens following the shadcn/ui CSS variable convention. Light/dark mode via .dark class.

--primary       /* Brand blue  */
--success       /* Green       */
--warning       /* Amber       */
--destructive   /* Red         */
--muted         /* Subdued     */
--accent        /* Hover/focus */
--border        /* Borders     */
--ring          /* Focus rings */

Use with Tailwind: bg-primary text-primary-foreground, bg-destructive text-destructive-foreground, etc.

--ring defaults to a softer shade of --primary; set it to use your own colour. See Theme › Focus Ring.

Typography

Manrope (--font-sans) and Fira Code (--font-mono) are not shipped; the theme falls back to the generic family, and Theme › Typography shows the --font-sans override.

Animation

Motion is a first-class but optional peer dependency (^12.8.0 || ^14.7.1). Components detect it at runtime — if absent, they fall back to CSS transitions.

Shared spring presets in src/lib/motion.ts:

• indicator — bouncy slide for tab indicators
• content — snappy, no overshoot for content transitions
• popup — snappy with slight bounce for popover/tooltip enter/exit
• overlay — gentle fade for dialogs/drawers
• micro — fast response for hover/focus

All motion respects prefers-reduced-motion except the Loader spinner (also shown by Button loading) and the indeterminate Progress pulse. They are essential status indicators, so they keep running.

Design Principles

• One component, one job. Select and Combobox are separate components — no god-component with mode switching.
• Lean set. If Tailwind can do it inline, it doesn't need a component.
• LLM-friendly. Conventional APIs, minimal indirection. Props over config objects.
• Motion built-in. Animations designed into the API from day one, not retrofitted.

Development

bun install
bun run build
bun run test
bun run lint

Versioning

chunks-ui is at 0.x, managed with Changesets and Conventional Commits. While the major is 0, a minor release may contain new features and breaking changes, and a patch release contains fixes only.

Docs

ui-kit.chunk-creations.com — Next.js 16 + Nextra 4, deployed on Vercel.

License

MIT, for the code and the documentation. The Chunks UI name and logo are not covered by it: see TRADEMARKS.md.