Draft
Get started
Changelog.
Sprout follows semver. Patch and minor releases are additive — you should never need to refactor on a minor bump. Major bumps are coordinated cross-team.
v3.25.1
Sep 2026
patch- search_tokens now indexes all 238 variables the token package ships, not the 113 it could describe. The semantic groups the Color page has pointed at since v3.21.0 — containers, states, layers and data — were returning no results, along with the whole alias layer, motion, layout and type. find_token_for_hex scores against them too, and flags when a hex is also a semantic token.
- get_icon takes a style. The set is 298 outlined and 224 solid icons under one namespace, and matching on name alone returned the outlined one every time — 208 of the 224 solid icons could not be fetched at all. search_icons now lists one row per name with the styles it exists in.
- The coverage board separates specification from code. Status was being read as "there is a component to import", which is wrong for Cards, Data grid, Dialog, Sidenav and Ribbon toolbar — all Ready, none with a React primitive. list_components and get_component now carry a code field derived from the seven primitives that actually ship.
- Fixed three component ids in the MCP source map: Checkbox and Switch pointed at the shared Inputs page rather than their own board rows, and AI disclosure label pointed at an id that does not exist, so get_component_source returned no docs link for it.
v3.25.0
Sep 2026
minor- New MCP reference page under Get started, listing every tool, prompt and resource the server exposes, what the playbooks replace, and exactly what the endpoint logs when you use it. The MCP tab on Connect is now the sixty-second version and links here.
- The MCP also serves its material as resources — playbooks, checklists, the theme CSS, the personas, and templated URIs for any component or icon — for clients that surface documents rather than tool calls. They are the no-argument views of the same builders the tools use, so the two cannot drift apart.
- The Connect page previously promised "seven tools" above a table that listed five. It now shows the four workflows you can run, grouped by what the server knows.
v3.24.0
Sep 2026
minor- The MCP server now carries the design playbooks, not just the data. Four workflows — build_ui, review_ux, write_ui_copy and apply_brand — turn what used to be three personal claude.ai skills into slash commands anyone with the MCP connected can run, and nine new tools back them: get_playbook, get_checklist, get_persona, get_product, get_component_source, get_theme_css, find_token_for_hex, check_contrast and get_logo. Updating a playbook is now an MR in this repo rather than an edit nobody else can make.
- check_contrast and find_token_for_hex mean a review reports measured numbers instead of estimates. They also settle three disagreements the old skills carried: the branding skill listed #457951, #24462B and #E1FFAE for primary-700, 800 and 300, where the token package says #447952, #24462a and #e1ffad. The differences are perceptually tiny — the first is 0.64 ΔE — but a brand document that disagrees with the token package is exactly what this is meant to stop.
- Two other conflicts resolved the same way: the skills gave minimum touch targets as a flat 44px and 48px, where the accessibility page has the real per-platform WCAG 2.2 answer, and the review skill named four Sprout principles where the canonical set is eight. The docs site wins in both cases.
- Personas, design principles, accessibility thresholds and the ethics commitments moved out of their page files into components/data, so the site and the MCP serve the same text rather than two copies that drift. Page rendering is unchanged.
- Prompt arguments are all optional strings and degrade rather than throw. MCP types prompt arguments as strings, so an enum in the schema turns a mistyped value into a broken slash command instead of a question.
v3.23.1
Sep 2026
patch- Previous/Next now derive from the sidebar tree instead of being hand-wired per page, fixing 10 pages that pointed at the wrong neighbour (or, on AI patterns, at an id that no longer existed). Reordering the nav now reorders the pager with it.
- AI disclosure label has a documented 24px minimum size, enforced in code — the caption renders at 54% of size, so anything smaller put words on screen under 11px. Same images-of-text reasoning as the existing 4.5:1 contrast rule.
- Receipt card renamed to Plan card, and its copy now says explicitly that it appears before the action rather than after. Review feedback showed the old name read as a post-hoc log, which is the opposite of its purpose.
v3.23.0
Sep 2026
minor- Card rewritten to match the latest Figma design: anatomy and spacing (media, overflow, title, subtitle, badges, body, action — every slot optional except the title), the three sizes, an interactive "Try me" playground for slots and order, the container tokens, media kinds, states, and four Do/Don't pairs.
- Card has no shipped primitive yet, so every demo on the page is a local mock built from Sprout tokens (colors, spacing, radii) rather than a real component import — flagged here so a future AceveCard primitive is not mistaken for prior art.
v3.22.0
Sep 2026
minor- New component: Floating tabs — the pill-shaped, mutually exclusive view switcher for the mobile app, shipped as a real primitive (AceveFloatingTabs) plus its full docs page: anatomy, spacing, three content variants, states, size, icon rules, do/don't and placement guidance for sharing a screen with a FAB.
- Colours on Floating tabs (#152F1A / #E1FFAD / #92B97A) are raw hex, not tokens yet — there is no brandSurface variable collection in the Sprout Figma file. Flagged on the component's Styles section rather than hidden.
v3.21.1
Sep 2026
patch- AI patterns rewritten to match the latest Figma design: five cross-cutting principles, a "which pattern is this?" trigger/output/autonomy table, the three-level autonomy ladder (Suggest → Draft → Act), shared AI infrastructure, Do/Don't guidance for signaling AI and loading states, the minimum control bar, and failure-state handling.
v3.21.0
Sep 2026
minor- Color page is now split into two sub-pages — "Semantic colors" (final usage tokens: containers, layers and states for Aceve green and the four semantic accents) and "All colours" (the raw palette ramps, unchanged). Both keep the Grid / Compact / List / Palette view switcher.
- Semantic swatches read live CSS variables (--sprout-containers-*, --sprout-states-*, --sprout-layers-*) so they flip correctly in dark mode, instead of a fixed light-theme hex.
- Semantic colors now covers every token sprout-tokens 0.1.0 ships: the Data group (--sprout-data-*), the two brand-surface states (--sprout-states-brand-surface-active and its translucent background), and the two brand-surface layers (--sprout-layers-brand-surface, --sprout-layers-on-brand-surface) that the first pass missed.
v3.20.0
Sep 2026
minor- Coverage board reconciled against the Sprout Figma library. Twelve components that exist in Figma but were missing from the board are now listed as Beta: Alert, Select, Textarea, List item, Button group, Dropdown button, Icon button, Fab button, Skeleton text, Skeleton button, Media and Carousel.
- Tooltip moves from Planned to Beta — the Figma component set already exists, only the docs page is outstanding.
- Combobox stays Planned, now with a pointer to Select for the closed-option-list case.
- Beta with no page link now has a defined meaning on the board: usable from the Figma library, documentation still to be written.
v3.19.1
Aug 2026
patch- New page: AI transparency & disclosure — six core principles, four disclosure categories (conversational AI, text/summaries, recommendations, code suggestions), terminology, and accessibility requirements.
v3.19.0
Aug 2026
minor- Brand & logos is now split into two tabs — Aceve branding and In Product branding. Everything that was on the page before is still there, just relocated.
- New brandmark guidance on the Aceve branding tab, from Aceve Visual Guidelines Chapter 2: how the logotype is built, primary and secondary colors, clearspace, and logotype and symbol placement — each with worked examples and do/don't lists.
- In Product branding gathers the product logotype carousel, with a direct link to the Sprout Slack channel for requesting updated product logos.
v3.17.0
Aug 2026
minor- New documentation-status tracking — a Draft / Ready for review / Done badge on tracked pages, and an internal "Docs status" overview (version, owner, last-updated) mirrored from a new Docs status page in the Sprout Figma file. Manually maintained, no automation.
v3.16.0
Aug 2026
minor- New AI disclosure label component — the EU AI Act (Article 50) transparency icon, in Basic, Fully AI-Generated and Partially AI-Modified variants, using the official EU icon set as-is. Inline and overlay placement, auto light/dark, plain-language ARIA labelling.
- First of the three "AI layer" components on the roadmap to ship — the disclosure label moves from planned to ready on the coverage board.
v3.15.0
Aug 2026
minor- New MCP server page (Get started) — how to connect Claude Code, Cursor or any MCP-aware AI tool to Sprout, what the seven tools can do in plain language, and a ready-to-paste example prompt.
v3.14.0
Aug 2026
minor- Sprout MCP server — open, read-only Model Context Protocol endpoint at aceve.design/api/mcp. Seven tools: search_tokens (colors with light/dark values, spacing, radii, shadows), search_icons + get_icon (exact names and SVG for all 297 icons), list_components + get_component (coverage board with maturity status), get_guidelines (voice rules and type scale) and get_version.
- Connect from Claude Code: claude mcp add --transport http sprout https://aceve.design/api/mcp — or add the URL as a custom connector in claude.ai.
v3.13.0
Jul 2026
minor- New Numeric input component (Beta) — one field for quantities, cost, markup and VAT. Built on a text input with inputMode, never type="number": integer/decimal modes, fixed precision, comma and period both parse, locale formatting on blur, no spinner arrows, no scroll-wheel edits. Requested by the Rise and Lume teams.
- The page ships six numeric-field rules, parsing tables, and copy-ready React and Tailwind reference implementations.
v3.12.1
Jun 2026
patch- Migrated GitLab from the self-managed instance to gitlab.com (aceve/aceve-design-system group). Updated repo, registry and merge-request URLs across the install, contribute and source links.
v3.12.0
Jun 2026
minor- New public UX Strategi page (People & ethics) — the public summary of Aceve's UX strategy, and the gateway to the internal area.
- New password-protected internal UX area — UX Pipelines, UX Strategy Internal, UX Labs and Ways of Working, for the UX team and invited collaborators. Access by request: contact Mikel von Krogh.
- Added an edge-middleware login gate (signed HttpOnly cookie) over /internal/*; internal pages stay out of search and the sitemap.
v3.11.1
Jun 2026
patch- New "Meet the makers" page (People & ethics) introducing the designers who build and maintain Sprout.
v3.11.0
Jun 2026
minor- Documented four components that were on the board but had no page: Cards and Dialog (Ready), Tabs and Context menu (Beta) — each now linked from the coverage board.
- New Accessibility foundation page — WCAG 2.1 AA floor, keyboard, screen-reader and reduced-motion guidance, gathered from the component pages into one place.
- Adoption page is now in the sidebar (Get started) — previously reachable only by direct link.
v3.10.3
Jun 2026
patch- Color page — Semantic: warning color corrected from Tailwind amber (#F59E0B) to Sprout warning.500 (#bf9c0c) to match Figma. Fixes light and dark warning tints. Step labels corrected: Success/Info/Danger are step 600, Warning is step 500.
- Tokens: success, warning, link color palettes now exported in COLORS for docs display.
v3.10.2
Jun 2026
patch- Figma webhook fixed end-to-end — passcode mismatch resolved, pipeline now triggers on every LIBRARY_PUBLISH.
- Figma sync now covers spacing (3xs–4xl) and motion durations (xfast–xslow) in addition to colors — sync:primitive updated.
- Motion page: updated to 5-step duration scale (50 / 150 / 250 / 500 / 1000ms) aligned with Figma variables.
- Spacing tokens 2xl / 3xl / 4xl corrected to 40 / 48 / 64px to match Figma spacing collection.
- Architecture page: step 03 now accurately describes sync:figma → sync:primitive → sync:icons order.
v3.10.1
Jun 2026
patch- Buttons page: added Figma Type ↔ React variant mapping table — Primary/Neutral/Danger/Success in Figma map to primary/secondary/destructive/success in React. subtle is a code-only variant.
- Contribute page: fixed blank icon in House rules (check-1 → check).
- Role page: fixed all broken tab and step icons in dark mode.
- All 97 remaining stale icon names remapped to Lineicons Pro across shell, showcase, architecture, and command palette.
v3.10.0
Jun 2026
minor- Icon library expanded to 297 icons — full Lineicons Pro set synced from the main Sprout Figma library (up from 96).
- Icon sync pipeline fixed: now targets the main Sprout library, strips nested path prefixes from component names, and cleans stale icons between runs.
- vendor/sprout-tokens updated with the full 297-icon bundle.
v3.9.0
Jun 2026
minor- New Contribute page — how anyone on the UX team clones, edits and ships changes to the docs and tokens repos, with worked examples for a new page and a new component.
- Code Connect went live: Button, Checkbox, Switch and Input now show their React snippet in Figma Dev Mode.
v3.8.0
Jun 2026
minor- Published the roadmap — Now / Next / Later themes from the design strategy, with shipped items receipted against the changelog.
- New Why it pays page: the published research behind design-system ROI (McKinsey Design Index, SEG SaaS Index) and the chain from design maturity to company value.
v3.7.0
Jun 2026
minor- Published the eight design principles — the public floor every Aceve screen is reviewed against.
- New Trust & direction page: the five strategy pillars and the Trust Commitment, quotable and public.
- New AI patterns page — the "extra apprentice" frame, the suggest → draft → act autonomy ladder, and the AI layer (disclosure, receipts, confidence, undo) ahead of EU AI Act Art. 50 (2 Aug 2026).
- Three AI components added to the roadmap: AI disclosure label, Receipt card, Confidence indicator.
- Voice: seventh writing rule — lead with the outcome, not the technology.
v3.6.0
Jun 2026
minor- Added the Adoption maturity model — a 5-level pyramid for how teams roll out Sprout, from brand foundations to full adoption.
- Framed Sprout as a guideline, not a mandate: align on foundations, raise UX to a good-enough floor, grow the validated component library over time.
v3.5.0
May 2026
minor- Adopted Lineicons Pro (perpetual license) as the canonical icon library — blended with custom Aceve icons via Figma sync.
- New /icons-page filter: source (Lineicons / Aceve / All) + license badges + per-tile origin marker.
- `@aceve/sprout-tokens` now ships icons as a separate export — `import { SPROUT_ICONS } from "@aceve/sprout-tokens/icons"`.
v3.4.0
May 2026
minor- Sprout — first public docs site for the Aceve Design System.
- Searchable icon library shipped with copy-to-clipboard.
- Dark mode and density tokens added to the theme layer.
v3.3.1
Apr 2026
patch- Tightened ribbon group divider rule to 1×64px (was 1×56px).
- Fixed: disabled secondary button border now uses --ink-300.
v3.3.0
Mar 2026
minor- New Version history drawer pattern — anchored 340px right.
- Added grid active fill token --grid-active (#E1FFAD).
v3.2.0
Feb 2026
minor- Adopted Lineicons (96-icon curated set, 2px round-cap stroke) as the canonical icon system.
- Voice & content rules formalised — verb+noun for every button.
v3.1.0
Jan 2026
minor- Suite Header height locked at 48px across every Aceve product.
- Sidenav tiles standardised to 64×64.