Changelog
What changed in each Monoline version.
Every change to the CSS, the React components and the CLI, newest first. The source is CHANGELOG.md.
Versions follow semver. Before 1.0, a minor version may change class names; each change is listed here.
0.5.0 - 2026-11-20
New design tokens, a redesigned docs site, and the docs now live at https://monoline.prashantdasari.com.
Added
- More design tokens in
@monoline/css, all additive and with no visual change at the default settings:--weight-regular|medium|bold,--leading-tight|normal|relaxed, a radius scale--radius-sm|md|lgderived from--radius(sodata-radius="soft|round"moves every step),--container-smto--container-2xl, breakpoints--bp-xsto--bp-2xl,--shadow-popover,--shadow-toast,--focus-ring,--border-widthand--opacity-disabled. Component stylesheets now read the weight, leading, focus ring, disabled opacity and toast shadow tokens instead of literals.@monoline/tokensexports the new tokens (weights and leading inTypography, containers and breakpoints inSpacing, the radius scale inRadius; shadows, focus ring, border width and disabled opacity are listed in$skipped). - The breakpoint tokens are for JavaScript and documentation only: CSS cannot use a variable inside
@media. The built-in stylesheets still use their own widths (560, 600, 760, 800, 860, 900, 1100 px and 40rem, 64rem); aligning them would change tablet layouts and is a separate decision.
Changed
- The repository is now
dasariprashant0/monolineand the docs moved from GitHub Pages to https://monoline.prashantdasari.com; the packagehomepagefields point there. - The docs site is redesigned (home,
/docsroutes, tabs, sidebar, playground page). - Card, dialog, alert, code block, empty state, segmented control and kbd set
border-radius: var(--radius-md)in their own stylesheets; the[data-radius]selectors for them inoptions.cssare gone. Badge, tag and button keep theiroptions.cssrules (round makes them pills).
0.4.0 - 2026-11-16
Much lighter, with a few breaking changes. Whole library 123.6 to about 95 KB gzip; a Dialog is 1.8 KB (was 14.1), a Select 4.9 KB (was 32.4), a Button 0.7 KB (was 1.8).
Breaking
Buttonnow defaults tovariant="solid"(wasline): the primary action, as in shadcn/ui, Mantine and Chakra. Usevariant="line"for secondary buttons.IconButton,CopyButtonand the other built-in buttons passvariant="line"themselves, so their look does not change. The CSS classes are unchanged:.btnplus.btn-solidor.btn-line.- Dialog, AlertDialog, Drawer and Command use the native
<dialog>element withshowModal()(free focus trap, inert page, Escape, top layer). Content refs areHTMLDialogElement.forceMountandasChildon content are gone; Dialog keepsmodal. - Popover, Tooltip, HoverCard, Select, DropdownMenu, ContextMenu and Menubar use one shared floating layer (side, align, offsets, flip, shift) instead of Radix and floating-ui. Menus and popovers are non-modal: the page stays interactive and a press outside closes them. The Radix
modalprop andforceMount/asChildon content are gone.--radix-select-*and--radix-popover-*custom properties are replaced by--anchor-widthand--available-height. The Select list keeps its items mounted (hidden) while closed so the trigger can show the chosen text. - The
asChildSlot is Monoline's own (utils/slot.tsx), not Radix's.
Added
- Shell components:
Sidebar,Navbar,AppShell,PageHeaderandBreadcrumbsAuto;block-dashboard-shellis rebuilt on them with the same props. @monoline/tokens: design tokens as W3C JSON, Figma variables, CSS and TypeScript types, generated from@monoline/css.- CLI:
monoline diff,updateandsearch, plusadd --allandadd --category. - VS Code snippets generated from the registry.
- Per-component CSS is the recommended path:
@monoline/css/core.cssplus@monoline/css/components/<name>.css. Each bundle includes the CSS of every component it renders, and@monoline/reactexports a generatedstylesmap. Measured: core 3.4 KB gzip, core plus the landing example 6.2 KB, plus the dashboard example 10.3 KB, against about 19 KB for everything. TextacceptsfullWidth; heading scale tokens--heading-1and--heading-2;.flow(and--flow) is documented and applied by Card, Dialog and.prosecontent.- Docs: every docs route is prerendered to
dist/<route>/index.htmlwith a sitemap and robots.txt (deep links work on static hosts); a load-only-what-you-use guide;docs/bundle-report.mdfromnode scripts/size.mjs --detail.
Accessibility and quality
- An accessibility-tree check for 41 components (
npm run ax, report indocs/a11y-report.md) and a screen-reader testing guide. This is a proxy for screen-reader behaviour, not a replacement for testing with NVDA, JAWS or VoiceOver. - New real-browser audits: every overlay on every docs page, and the three example apps (contrast, text overlap, hover and focus in each state).
- Fixes: native select arrow matches the custom select in every theme; horizontal tab lists scroll instead of widening the page on phones; dialog titles leave room for the Close link; a docs heading anchor no longer leaks into a dialog's accessible name; calendar outside-day hover contrast.
- 1,446 unit tests and 123 real-browser tests; CI runs the accent audits in parallel.
0.3.0
Monoline is now a monorepo: @monoline/css, @monoline/react, the monoline CLI and a docs app.
- 129 components and hooks (was 28 on the first monorepo cut): forms (combobox, autocomplete, multi-select, tags-input, calendar, date-picker, time-picker, color-picker, OTP, number and password inputs, file-upload), overlays (alert-dialog, drawer, hover-card, context-menu, menubar, toast), data display (data-table, tree, timeline, carousel, table, stat), navigation (navigation-menu, stepper, toolbar), layout (stack, flex, box, grid, container), 13 effects, 11 page blocks and 23 hooks.
- Look options. Nine accents (added rose, teal, amber, slate),
data-font,data-radiusanddata-densityinpackages/css/src/options.css. All accents pass the contrast checks in every theme. - CLI.
npx monoline add | list | info | initcopies components fromregistry/. - AI-readable.
meta.jsonper component, generatedregistry/,llms.txt,llms-full.txt,AGENTS.md. - Quality. A test renders every demo with axe and a no-console-errors check;
npm run checkalso tests contrast across 3 themes and 9 accents. - Docs site. Search, a Customise panel (theme, accent, font, corners, density), guides and per-component pages.
- Research.
docs/research/compares 12 libraries and the roadmap is indocs/ROADMAP.md.
0.2.0
The kit is now general purpose and named Monoline (was @personal/ui).
- Rename. Package
monoline-ui; thebrand.cssoverride is replaced bydata-accentpresets: orange (default), green, blue, violet, incss/accents.css. - New components. Checkbox, radio, range, progress, spinner, skeleton, table, accordion, tooltip, dropdown menu, breadcrumb, pager, steps, top bar, avatar, tag, stat, prose, link, divider, skip link, input group, field states, toast region.
- Layout utilities.
css/utilities.css: container, section, flow, cluster, grid, split, gap helpers, responsive hide. - Behaviours.
js/monoline.js: tabs, dropdown dismissal, drawer, dialog, toast, copy, theme and accent switching with saved choice. Optional. - Distribution.
css/monoline.cssand.min.cssfor a CDN link,tokens/tokens.json(W3C design tokens format), npm exports. - Quality.
npm run checktests 63 contrast pairs across 3 themes and 5 accents and bans raw colours in components; CI runs it and verifies the built files are committed. - Docs. The docs site at the repo root replaces the example page and the old gallery as the main reference.
- Print styles and a
.skip-link.
0.1.0
First version: tokens, base, components, React wrappers, three themes.