What's new

The docs in the packages

Highlights

• @butteryui/core ships every page of the docs as Markdown, with llms.txt and llms-full.txt, and @butteryui/react ships manifest.json, the examples as files and what the MCP server answers from, so an agent in an app reads the installed version's docs from node_modules, offline. buttery create and buttery init point an app's agents at them.
• Stylelint fails a var(--bt-*) of a name that buttery and the project don't declare, naming the nearest token. Development warnings end with a link to the docs. An OverflowCluster in a section's actions folds and unfolds with the page.
• LayoutGuard checks a rule or two per frame, so a check doesn't hold up what the page is doing, and the overlap rule is seven times cheaper. The agent evaluation ran its seven tasks with two coding agents, and what it found is fixed: a layout check under load no longer waits on an animation that reduced motion cut short, and a Grid with responsive columns warns when nothing above it is a size container.

The command line

Highlights

• npx create-buttery my-app --template dashboard starts an app from a template in any folder, with its lint configs, Playwright specs, agent files and the MCP server in each coding agent's config. buttery add page writes any of 16 pages from buttery's patterns, wired into a dashboard app's routes and sidebar, and buttery create component starts a component on buttery's public parts.
• buttery check runs the checks from @butteryui/test on pages of the running app, starting its dev server when it isn't running, and prints each problem once with its fix, or every one with --json. buttery doctor checks an app's setup and buttery init sets buttery up in an app you have.
• The dashboard template has a page of every kind, and buttery_scaffold sets an example that isn't a whole page inside an AppPage or a section of a Page, so every scaffolded page has the page grammar's padding and title.

The MCP server, and passwordless sign-in

Highlights

• @butteryui/mcp gives coding agents five read-only tools over the Model Context Protocol: search, get, scaffold, lint and a layout check, on protocol 2026-07-28 and the 2025 handshake. Lint catches literal values a component's props don't take, such as gap="16px", and says what to write instead.
• AuthFlow signs people in or up with a code sent to their email or phone, built from IdentifierField, OneTimeCodeField and the useOtpFlow hook, which work on their own too. The roastery demo and the dashboard template sign in with it.
• The docs search finds sign-in for "login" and "passwordless", and the segmented control for "switch between".

New components (3)

The docs site, and buttery on npm

Highlights

• @butteryui/core, @butteryui/react, @butteryui/test and @butteryui/lint are on npm, released together at one version, and every docs page is Markdown at its path plus .md, with llms.txt listing them all for coding agents.
• Sheet, Accordion, Faq, ContextMenu and the Catalog parts are new, and fields, tabs, badges, cards, tables and a dozen more take variant, size, shape or layout options, each defaulting to the look they already had.
• expectButtery and LayoutGuard check three more things: text crowding the line under it, a word broken across lines, and controls that sit off the line beside them; checkButtery returns what they find instead of failing. pnpm new-app starts from the dashboard, editor or marketing template, which the new demos, Deckhand and the Halfmoon shop, are built on.

New components (5)

App kit

Highlights

• The dashboard shell: AppShell with Sidebar and TopBar, AppPage, PageHeader and tabs, built to the page grammar in the layout rules.
• Data and charts: DataTable with saved views, filters and column settings, MetricCard, StatTabs and in-house line, area and bar charts.
• Settings, search and panels: SettingsPage and its rows, CommandSearch with typed sources and filters, SearchResults, SidePanel and the form, consequence and full-screen dialogs.

New components (56)

Choreography

Highlights

• Dialogs that grow from 0.97 and rise into place, and an onboarding flow that morphs between its steps.
• NavBar with one MorphMenu card that changes shape as it moves between menus.
• The marketing patterns: heroes, a logo strip, stats, a bento grid whose cards open into dialogs, and an article layout.

New components (19)

App patterns

Highlights

• Swatch grids, a color picker, toasts, menus and selects.
• AppShell, the inspector and the stage, the pieces of an editor.
• Card Studio, an original card editor built only from buttery's public components. Deckhand, a slide editor, replaced it in 0.9.

New components (13)

Forms and text

Highlights

• Text fields, a password field, a text area, checkboxes and switches, all sharing one field layout.
• Sign-in and sign-up forms that check as you go and sum up errors where they can be fixed.
• TextStack for a title, a line and a caption that keep their spacing on trimmed text.

New components (10)

Controls

Highlights

• Button with four variants, three sizes, a loading state and a navigation arrow that grows a stem.
• Segmented controls with a sliding indicator, sliders, number fields, tooltips and keycaps.

New components (12)

Motion

Highlights

• Motion tokens and presets: three springs, durations, easings, and Presence, Morph, Reveal, Stagger and Loop.
• The buttery factory, which gives any element token-typed props for surfaces, layout and motion.
• Settle times measured frame by frame against the motion spec, in Chromium and WebKit.

New components (8)

Guardrails

Highlights

• The layout primitives and layers: Stack, Inline, Grid, Surface, Layer, Popover and the rest.
• expectButtery for Playwright, LayoutGuard in development, and lint configs that keep values on the tokens.

New components (16)

Foundation

Highlights

• The tokens, in light and dark and in comfortable and compact density, and the CSS recipes built on them.
• ButteryProvider, createTheme and the palettes.