Changelog

September 2026 - Get started docs

A full Get started path for Cubix: Installation, Theming, CLI, Typeset, Skills, Registry, and Changelog - written for teams shipping production UI.

What shipped

The docs sidebar now walks you from first install to publishing your own registry. Each page uses the same Cubix patterns as the component docs: clear sections, package-manager command tabs, and dotted inline links.

• Installation - init, bases, and manual bootstrap.
• Theming - live token palette, radius scale, and default CSS from globals.css.
• CLI - init, add, view, search, build, and info.
• Typeset - fonts, type scale, and rhythm presets for docs and chat.
• Skills - Agent Skills install and project-aware Cubix guidance.
• Registry - catalog and item schemas, namespaces, and authoring rules.

Try it

Start from Installation, then pick a component from the catalog:

npx cubix@latest init
npx cubix@latest add button

September 2026 - Agent UI primitives

First-class building blocks for chat and agent products - conversation shells, prompt input, thinking, tool calls, streaming text, and related surfaces.

What's included

Cubix now ships AI-oriented registry items alongside classic forms and overlays. Source lives under components/cubix like every other primitive, so you own the files and can wire your backend without a closed SDK.

• Conversation - stick-to-bottom chat shell with empty and scroll controls.
• Prompt Input - composer patterns for agent turns.
• Thinking, Tool Call, Streaming Text, Code Block, Sources, and more.
• Message Scroller - Cubix-owned scroller with no third-party UI kit dependency.
• Blocks - agent chat workspace templates under /blocks/ai-agent.

Install an agent surface

npx cubix@latest add conversation prompt-input thinking tool-call

September 2026 - Three bases, one API

Install against Base UI, React Aria, or Radix UI while keeping the Cubix visual API aligned across docs, registry items, and CLI flags.

How it works

Default base is Base UI. Pass --base aria or --base radix when you init or add a component. Docs pages expose a base switcher so you can compare the same control across backends without changing product copy or token usage.

• Named exports, data-slot on every part, cn() for className.
• Semantic tokens only - background, foreground, muted, accent, primary, destructive, border, input, ring.
• asChild maps to the primitive compose API (render on Base UI, Slot on Radix).

npx cubix@latest add dialog --base radix
npx cubix@latest add dialog --base aria

September 2026 - Design system foundation

Token-first theming in oklch, Tailwind CSS v4, Geist typography, Cubix scrollbar, and a production engineering bar for junior-to-senior teams.

Highlights

• Light and dark palettes as CSS variables in app/globals.css.
• Radius scale derived from a single --radius token.
• Geist Sans, Geist Mono, and IRANSans XV for Persian / RTL.
• cubix-scrollbar utility applied consistently across the docs site.
• Registry catalog at public/r with index.json and per-component items.

Engineering standard

Cubix targets real production apps. Components and docs avoid placeholder code, keep the three bases in sync, and treat accessibility, TypeScript, and empty/loading/error states as required - not optional polish.