Release notes
Changelog.
Every release, in descending date order. Lumino follows semantic versioning — MAJOR breaks, MINOR adds, PATCH fixes. We ship a minor on the first Tuesday of each month, and patches whenever something bites.
Versioning policy
Major · X.0.0
BreaksToken renamed or removed. Component API change. Ships with a codemod and a six-month deprecation window.
Minor · 1.X.0
AddsNew components, new tokens, new features. No breakage in existing APIs. Monthly cadence.
Patch · 1.0.X
FixesBug fixes, a11y improvements, visual corrections. Shipped ad-hoc — usually same day.
Recent releases
First stable release.
The full Lumino design system: 120+ tokens, 3 themes × 2 modes × 3 densities, 25+ components, the Lumino mark with 13 preset variants, and a complete documentation site. This is what we'll build on.
Shipped
- Three themes: Pro (adult, sans), Studio (creative, Fraunces), Playful (kid, Nunito)
- Dark and light modes with warm-shifted light surfaces
- Three densities: compact, comfy, spacious
- Parametric logo component — solid below 28px, stroked above
- 25+ components with class-based and React APIs
- Pages: landing, getting-started, tokens, themes, logo, components, patterns, icons, writing, a11y, changelog
- Tools: contrast checker, theme forge, marketing studio
Known limitations
- Tailwind preset ships in 1.1.0
- Web-component bundle is beta
- No Figma library yet — planned for 1.2.0
RC4 — logo lazy-load & favicon legibility.
Fixed the logo rendering race on Foundation pages and pushed a solid variant for sub-28px sizes after favicon rendering tests failed at 16px.
Fixed
LuminoMark no longer flashes on SSR hydrate when used above the fold
- Favicon legibility at 16px (petals were bleeding — solid mode now kicks in automatically)
- Portal left-rail: collapsed state now respects
prefers-reduced-motion
- Table: filter chip active state missing border in light mode
Studio theme · serif on dark.
The warm Studio variant lands — Fraunces headlines on cream or warm ink, built for teen and creative-professional surfaces. Stacks with all existing modes and densities.
Added
- Studio theme:
data-theme="studio"
- Fraunces font family:
--font-display
--hero-weight token for per-theme headline weight
- Theme forge tool (beta) for exporting custom themes
Changed
--color-accent default shifted from #e88863 to #d97757 for better contrast against cream
- Accordion: summary padding 10 → 12
Playful theme + density modifier.
Rounded-everything theme for kids and the density modifier that scales spacing and text across any theme.
Added
- Playful theme — Nunito, full-round radii
data-density: compact · comfy · spacious
--z-* elevation scale (7 layers)
- 55 new icons (flask, brain, sparkle, spark-path, ping, …)
Changed
- Surface palette rebuilt with warm-shifted dark values (15110d base)
- Focus ring moved to
--color-accent-glow 40% alpha
A11y sweep.
One-time pass across every component to raise contrast and keyboard behavior to WCAG 2.2 AA.
Fixed
- Tertiary text (
--color-text-tertiary) raised from #8a7f6b to #9a8f7b — 4.5:1 on base
- Modal: focus now traps correctly; Esc closes; focus returns to trigger
- Toast:
aria-live="polite" added
- Icon button: requires
aria-label (TS error if missing)
- Skip-to-content link: now visible on
:focus-visible
Pro theme · foundation.
The adult, precise, sans-only base theme. The first full token set, the first components, the first page of docs. Everything else extends from here.
Added
- Initial token set: color, text, space, radius, shadow, motion
- Components: Button, Card, Input, Textarea, Select, Switch, Checkbox, Radio, Slider, Badge, Avatar, Progress, Tabs, Table, Modal, Toast, Tooltip, Breadcrumb, Accordion
- Dark mode + light mode (paired with Inter Tight)
- Initial icon set — 30 monoline glyphs
Upcoming
What's being worked on for the next releases.
1.1.0 — Tailwind preset
Tokens exposed as Tailwind utilities. Drop-in config. Target: Dec 2025.
1.2.0 — Figma library
Parity components and tokens, synced via Tokens Studio. Target: Jan 2026.
1.3.0 — Data visualization
Chart primitives (line, bar, sparkline, scatter) using the color scale. Target: Feb 2026.
2.0.0 — CSS-first tokens
Move from CSS custom properties to @property declarations. Animated tokens. Breaking. Target: Mid-2026.