3.0 in numbers.
Fewer packages to install, a faster build and lighter dashboards, with the same look. Measured on 17 November 2026: Once UI 2.8.0 against 3.0.0-beta.3, and Stack on each. Where 3.0 is heavier, we say so.855
packages Once UI adds to a Next app with a chart92 MB → 38 MB on disk254 KB385 KB
JavaScript on the dashboard block, gzip−34%, same block, same look6.1 s9.1 s
next build of the starter, median of 3compile 5.7 s → 3.0 s6.4 MB8.9 MB
core package unpacked1,996 → 1,176 files01INSTALL
47 fewer packages for an app with charts.
2.x drew charts with recharts and compiled its styles with sass, so a dashboard pulled in d3, redux and a Sass compiler. 3.0 draws its own SVG and ships plain CSS. The runtime dependencies stay the same three: floating-ui, clsx and date-fns.Peer dependencies to install2.8.0: recharts, sass3.0: none for charts or styles
Packages added to a Next app2.8.0: 55 (92 MB)3.0: 8 with fx (38 MB)
Runtime dependencies2.8.0: 33.0: the same 3
02WEIGHT
A third less JavaScript where the charts are.
Same blocks, built with Next 16.4.6 and measured in the browser, gzip. The dashboard block loses 131 KB because the chart renderer is ours. A page with no chart is 4% heavier on 3.0, and its CSS grows from 41 to 48 KB with the new tokens; we are trimming both in the 3.x minors.JavaScript per pageKB, gzip, lower is better
| label | 2.8.0 | 3.0 |
|---|---|---|
| Starter page JS | 210 | 219 |
| Dashboard JS | 385 | 254 |
| Stack landing JS | 541 | 480 |
| Stack dashboard JS | 682 | 499 |
0200400600800Starter page JSDashboard JSStack landing JSStack dashboard JS
03STACK
Stack moved to 3.0 in one codemod run.
The 3.0 codemod rewrote Stack's 2.x source in 1.2 seconds: 1,016 changes across 156 files, with 9 spots left to fix by hand. The app looks the same, its dashboard ships 27% less JavaScript and its landing 11% less. Build time stayed level at about 34 seconds; CSS grew from 57 to 63 KB.1,016
changes the codemod made156 files, 1.2 s9
left to fix by handeach one reported499 KB682 KB
dashboard JavaScript, gzip−27%480 KB541 KB
landing JavaScript, gzip−11%

2.8.0
3.0


2.8.0
3.0
04AGENTS
Agents write about 40% less code from Stack.
In our own test runs, coding agents built the same app from Stack with about 40% less code than from scratch (54k → 33k tokens written, median of 3), and the same checks passed. Total tokens came out about even, so we do not claim a cheaper build. 3.0 ships what agents read with the package: AGENTS.md, a component spec, llms.txt and the once-ui-mcp server.33k54k
tokens of code an agent wroteStack vs scratch, median of 324/24
checks passedsame gate for both17
meanings of a bare numberpx everywhere05API
One way to say each thing.
3.0 is the one breaking release before 2027. It spends the break on consistency: names that meant the same thing became one name, and the codemod rewrites them.variant, scheme, color, hue, statetone
One prop picks the palette on Button, Tag, Feedback, Toast, Table rows and gauges.rem, px, vh or a quarter percentpx
A bare number means pixels on every size, spacing and position prop.onChange(value), onSelect, onTogglevalue · defaultValue · onValueChange
Every state follows one shape, and onChange is the native event again, so form libraries register on any field.Modal, Swiper, Badge, Chip, InfoTip, DataTable…Dialog, Carousel, Tag, Tooltip, Table
Overlapping components fold into one each; effects move to @once-ui-system/fx, page sections to blocks.100145
modules in the root barrel56 moved out or folded, 11 new3163
forwardRef calls in coreref is a plain prop on React 19271208
components in the agent specnew subpaths: calendar, canvas, richtext, scene442320
test files in the repoabout 2,980 → 4,280 cases06METHOD