Skip to content
SproutAceve · v3.35.0
Overview What is your role? Connect to Sprout MCP reference Adopting Sprout
Brand & logos Color Typography Spacing & layout Elevation Iconography Accessibility
Overview Alert Avatar Badge Breadcrumb Buttons Cards Checkbox Data grid Dialog Dropdown button Fab button Floating tabs Inputs Menu Navigation Numeric input Progress bar Progress ring Radio button Ribbon toolbar Switch Tabs Tag Tooltip
Interaction & motion Voice & content Product patterns
AI patterns AI transparency & disclosure AI disclosure label AI labels in marketing
Design principles Personas Trust and ethics Meet the makers
Component labnew Build the systemplay Tower of tokensplay Site runnerplay
How it works Changelogv3.35 Roadmap Contribute
Storybook
Playground

Component lab.

Every Sprout component, working, on one page. Use them, then flip a card for the code, the repo path and the tokens behind it. Switch to Sprout next to see the same components in a proposed next-generation skin.

Components
40
React primitives
10
Tokens
238
Sprout
v3.35.0
@aceve/sprout-tokens
0.1.3

Buttons

React

Buttons

Import

import { AceveButton } from '@/components/primitives';

Usage

<AceveButton variant="primary" appearance="filled" size="m" icon="plus">
  Save quote
</AceveButton>

<AceveButton variant="danger" appearance="outlined" icon="trash-1">
  Delete
</AceveButton>

In the repo

Sourcecomponents/primitives/AceveButton.jsx
Code Connectcomponents/primitives/AceveButton.figma.tsx

Tokens · click to copy

Ready · since v3.2Storybook Read the docs

Button group

Spec
Showing the week

Button group

Markup and tokens

<div role="group" aria-label="Calendar range" class="btn-group">
  <button aria-pressed="false">Day</button>
  <button aria-pressed="true">Week</button>
  <button aria-pressed="false">Month</button>
</div>

.btn-group { border: 1px solid var(--sprout-layers-outline);
  border-radius: var(--sprout-radius-md); }
.btn-group [aria-pressed="true"] {
  background: var(--sprout-states-primary-selected);
  color: var(--sprout-containers-on-primary-container); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Beta · since v3.20

Dropdown button

Spec
Last action: Send quote

Dropdown button

Markup and tokens

<span class="dropdown-button">
  <button>Send quote</button>
  <button aria-haspopup="menu" aria-expanded="false"
          aria-label="More actions">⌄</button>
</span>

/* menu surface */
background: var(--sprout-layers-overlay);
box-shadow: var(--sprout-shadow-overlay);
border-radius: var(--sprout-radius-md);

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/DropdownButtonPage.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Icon button

Spec

Icon button

Markup and tokens

<button class="icon-button" aria-label="Bold" aria-pressed="true">
  <Icon name="bold" size={20} />
</button>

.icon-button { width: 38px; height: 38px;
  color: var(--sprout-layers-functional-icons);
  border-radius: var(--sprout-radius-md); }
.icon-button:hover { background: var(--sprout-states-surface-hovered); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Beta · since v3.20

Fab button

Spec

Fab button

Markup and tokens

<button class="fab" aria-label="Create">
  <Icon name="plus" size={24} />
</button>

.fab { width: 56px; height: 56px;
  background: var(--sprout-containers-primary);
  color: var(--sprout-containers-on-primary);
  border-radius: var(--sprout-radius-pill);
  box-shadow: var(--sprout-shadow-floater); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/FabButtonPage.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Select

Spec

Select

Markup and tokens

<button role="combobox" aria-haspopup="listbox"
        aria-expanded="false" aria-labelledby="unit-label">
  Square metres
</button>
<div role="listbox">
  <button role="option" aria-selected="true">Square metres</button>
</div>

[role="option"]:hover { background: var(--sprout-states-surface-hovered); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Beta · since v3.20

Inputs

React
Shown on quotes and invoices
Enter a full email address, like name@company.com

Inputs

Import

import { AceveInput } from '@/components/primitives';

Usage

<AceveInput
  label="Project name"
  value={name}
  onChange={setName}
  help="Shown on quotes and invoices"
  error={name ? '' : 'Give the project a name'}
/>

In the repo

Sourcecomponents/primitives/AceveInput.jsx
Code Connectcomponents/primitives/AceveInput.figma.tsx

Tokens · click to copy

Ready · since v3.2Storybook Read the docs

Textarea

Spec
50 of 140 characters

Textarea

Markup and tokens

<label for="note">Note to the crew</label>
<textarea id="note" rows="3" maxlength="140"
          aria-describedby="note-count"></textarea>
<span id="note-count">51 of 140 characters</span>

textarea { border: 1px solid var(--sprout-line-strong);
  border-radius: var(--sprout-radius-sm);
  background: var(--sprout-layers-surface); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Numeric input

React
pcs
kr
Line total2 994 kr

Numeric input

Import

import { AceveNumericInput } from '@/components/primitives';

Usage

<AceveNumericInput
  label="Unit cost"
  mode="decimal" precision={2} min={0}
  locale="sv-SE" suffix="kr"
  value={cost}
  onChange={setCost}
  onValueChange={(n) => save(n)}  // parsed number, on blur
/>

In the repo

Sourcecomponents/primitives/AceveNumericInput.jsx

Tokens · click to copy

Beta · since v3.13Storybook Read the docs

Checkbox

React

Checkbox

Import

import { AceveCheckbox } from '@/components/primitives';

Usage

<AceveCheckbox
  label="Maja Lind"
  checked={checked}
  onChange={setChecked}
/>

In the repo

Sourcecomponents/primitives/AceveCheckbox.jsx
Code Connectcomponents/primitives/AceveCheckbox.figma.tsx

Tokens · click to copy

Ready · since v3.3Storybook Read the docs

Radio button

React

Radio button

Import

import { AceveRadio } from '@/components/primitives';

Usage

<div role="radiogroup" aria-label="How to split the cost">
  <AceveRadio name="split" value="even" label="Split evenly"
    checked={v === 'even'} onChange={() => setV('even')} />
  <AceveRadio name="split" value="hours" label="By hours worked"
    checked={v === 'hours'} onChange={() => setV('hours')} />
</div>

In the repo

Sourcecomponents/primitives/AceveRadio.jsx

Tokens · click to copy

Beta · since v3.31.0Storybook Read the docs

Switch

React

Switch

Import

import { AceveSwitch } from '@/components/primitives';

Usage

<AceveSwitch
  label="Remind the crew at 07:00"
  on={on}
  onToggle={setOn}
/>

In the repo

Sourcecomponents/primitives/AceveSwitch.jsx
Code Connectcomponents/primitives/AceveSwitch.figma.tsx

Tokens · click to copy

Ready · since v3.3Storybook Read the docs

Toast

React
Uses the docs’ own pushToast

Toast

Import

import { pushToast } from '@/components/primitives';

Usage

pushToast('Time sheet sent to Maja');

// <ToastStack /> is already mounted once in AppShell.

In the repo

Sourcecomponents/primitives/toast.js

Tokens · click to copy

Planned

Floating tabs

React

Floating tabs

Import

import { AceveFloatingTabs } from '@/components/primitives';

Usage

<AceveFloatingTabs
  items={[
    { key: 'today', label: 'Today', icon: 'home-2' },
    { key: 'jobs',  label: 'Jobs',  icon: 'briefcase-1' },
    { key: 'time',  label: 'Time',  icon: 'stopwatch' },
  ]}
  activeKey={tab}
  onChange={setTab}
/>

In the repo

Sourcecomponents/primitives/AceveFloatingTabs.jsx

Tokens · click to copy

Beta · since v3.22Storybook Read the docs

Tabs

Spec

3 quotes are waiting for the customer.

Tabs

Markup and tokens

<div role="tablist" aria-label="Quotes">
  <button role="tab" aria-selected="true">Open</button>
  <button role="tab" aria-selected="false" tabindex="-1">Won</button>
</div>

[role="tab"][aria-selected="true"] {
  color: var(--sprout-accent-default); font-weight: 600;
  border-top: 2px solid var(--sprout-accent-default); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/TabsPage.jsx

Tokens · click to copy

Beta · since v3.5Read the docs

Badge

Spec
In reviewPaidExpiringOverdueDraft

Badge

Markup and tokens

<span class="badge">Paid</span>

.badge { padding: 2px 7px 4px; font-size: 12px; line-height: 16px;
  background: var(--sprout-containers-success);
  color: var(--sprout-containers-on-success);
  border-radius: var(--sprout-radius-xs); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/BadgePage.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Breadcrumb

Spec
  1. Q-2041

Breadcrumb

Markup and tokens

<nav aria-label="Breadcrumb">
  <ol>
    <li><a href="/projects">Projects</a></li>
    <li><a href="/projects/12">Kitchen renovation</a></li>
    <li><span aria-current="page">Q-2041</span></li>
  </ol>
</nav>

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/BreadcrumbPage.jsx

Tokens · click to copy

Beta · since v3.26Read the docs

Tag

Spec
PlumbingUrgentOn holdPaidInternal

Tag

Markup and tokens

<span class="tag">Plumbing
  <button aria-label="Remove Plumbing">×</button>
</span>

.tag { height: 38px; padding: 0 12px;
  background: var(--sprout-containers-primary-container);
  border: 1px solid var(--sprout-containers-primary);
  color: var(--sprout-containers-on-primary-container);
  border-radius: var(--sprout-radius-pill); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/TagPage.jsx

Tokens · click to copy

Beta · since v3.30Read the docs

Avatar

Spec
Maja Lind is on site

Avatar

Markup and tokens

<span role="img" aria-label="Maja Lind" class="avatar">ML</span>

.avatar { width: 38px; height: 38px;
  border-radius: var(--sprout-radius-circle);
  background: var(--sprout-surface-default);
  border: 1px solid var(--sprout-line-default); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/AvatarPage.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Alert

Spec
Quote expires in 2 days
Send a reminder so the customer can accept in time.

Alert

Markup and tokens

<div role="status" class="alert">
  <div class="alert-bar"></div>
  <strong>Quote expires in 2 days</strong>
  <p>Send a reminder so the customer can accept in time.</p>
</div>

.alert-bar { height: 4px; background: var(--sprout-status-warning); }
.alert--filled { background:
  color-mix(in srgb, var(--sprout-status-warning) 22%, var(--sprout-surface-canvas)); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/AlertPage.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Progress bar

Spec
Budget used62%

Progress bar

Markup and tokens

<div role="progressbar" aria-label="Budget used"
     aria-valuenow="62" aria-valuemin="0" aria-valuemax="100"
     class="bar"><div style="width: 62%"></div></div>

.bar { height: 8px; background: var(--sprout-surface-3);
  border-radius: var(--sprout-radius-pill); }
.bar > div { background: var(--sprout-accent-default); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/ProgressBarPage.jsx

Tokens · click to copy

Beta · since v3.31.0Read the docs

Progress ring

Spec
1/4
Invoices paid

Progress ring

Markup and tokens

<svg width="100" height="100" style="transform: rotate(-90deg)">
  <circle r="48" cx="50" cy="50" fill="none" stroke-width="4"
          stroke="var(--sprout-surface-3)" />
  <circle r="48" cx="50" cy="50" fill="none" stroke-width="4"
          stroke="var(--sprout-accent-default)" stroke-linecap="round"
          stroke-dasharray="301.6" stroke-dashoffset="226.2" />
</svg>

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/ProgressRingPage.jsx

Tokens · click to copy

Beta · since v3.31.0Read the docs

Tooltip

Spec
Print quoteShareArchive project

Tooltip

Markup and tokens

<button aria-describedby="tip-print" aria-label="Print quote">…</button>
<span role="tooltip" id="tip-print">Print quote</span>

[role="tooltip"] { padding: 4px 8px;
  background: var(--sprout-color-neutral-1000);
  color: var(--sprout-color-neutral-0);
  border-radius: var(--sprout-radius-sm); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/TooltipPage.jsx

Tokens · click to copy

Beta · since v3.20Read the docs

Skeleton text + Skeleton button

React

Skeleton text

Import

import { Skeleton } from '@/components/primitives';

Usage

<div aria-busy="true">
  <Skeleton width="60%" height={18} />
  <Skeleton width="100%" height={12} />
  <Skeleton width={120} height={38} />  {/* button-sized */}
</div>

In the repo

Sourcecomponents/primitives/Skeleton.jsx

Tokens · click to copy

Beta · since v3.20

List item

Spec

List item

Markup and tokens

<button class="list-item" aria-pressed="true">
  <span class="avatar">JB</span>
  <span><b>Jonas Berg</b><small>Electrician · arrives 09:30</small></span>
  <span class="badge">On the way</span>
</button>

.list-item:hover { background: var(--sprout-states-surface-hovered); }
.list-item[aria-pressed="true"] { background: var(--sprout-states-primary-selected); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Beta · since v3.20

Cards

Spec
On schedule
Kitchen renovationStorgata 12 · due 28 Nov

Cards

Markup and tokens

<article class="card">
  <img class="card-media" alt="" />
  <h3>Kitchen renovation</h3>
  <p>Storgata 12 · due 28 Nov</p>
  <AceveButton size="s" appearance="outlined">Open project</AceveButton>
</article>

.card { background: var(--sprout-layers-surface);
  border-radius: var(--sprout-radius-md);
  box-shadow: var(--sprout-shadow-surface); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/CardsPage.jsx

Tokens · click to copy

Ready · since v3.2Read the docs

Carousel + Media

Spec
Before — old tiles
Plumbing roughed in
After — ready to hand over

Carousel

Markup and tokens

<div role="group" aria-roledescription="carousel" aria-label="Site photos">
  <div class="track">  <!-- scroll-snap-type: x mandatory -->
    <figure class="media">…<figcaption>Before</figcaption></figure>
  </div>
</div>

.media { aspect-ratio: 16 / 9; border-radius: var(--sprout-radius-md);
  scroll-snap-align: center; }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Beta · since v3.20

Date picker

Draft
November 2026
MoTuWeThFrSaSu
Site visit on Thu, 19 Nov 2026

Date picker

Markup and tokens

<div role="grid" aria-label="November 2026">  <!-- Monday first -->
  <button role="gridcell" aria-selected="true">19</button>
</div>

[role="gridcell"][aria-selected="true"] {
  background: var(--sprout-containers-primary);
  color: var(--sprout-containers-on-primary);
  border-radius: var(--sprout-radius-circle); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Planned

Data grid

Spec
ItemQtyUnitUnit cost
Wall tiles 20×2032m²575 kr18 400 kr
Tile adhesive6pcs289 kr1 734 kr
Labour, tiling24h690 kr16 560 kr
Waste removal1pcs1 850 kr1 850 kr
Sum · 1 selected38 544 kr
Click the grid, then use arrow keys. Space selects a row, + and − change a quantity.

Data grid

Markup and tokens

<div role="grid" aria-label="Cost lines" tabindex="0">
  <div role="row">
    <span role="columnheader">Item</span>
    <span role="columnheader" aria-sort="descending">Total</span>
  </div>
  <div role="row" aria-selected="true">
    <span role="gridcell">Wall tiles 20×20</span>
    <span role="gridcell" class="num">18 400 kr</span>
  </div>
</div>

[role="gridcell"][data-active="true"] { background: var(--sprout-grid-active); }
.num { text-align: right; font-variant-numeric: tabular-nums; }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/DataGridPage.jsx

Tokens · click to copy

Ready · since v3.3Read the docs

Combobox

Draft

Combobox

Markup and tokens

<input role="combobox" aria-expanded="true"
       aria-controls="materials" aria-autocomplete="list" />
<div role="listbox" id="materials">
  <button role="option">Plasterboard 13 mm</button>
</div>

/* free text is allowed — an unmatched value becomes a new option */

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/lab/specs.jsx

Tokens · click to copy

Planned

Ribbon toolbar

Spec
Insert
Format
Data

Ribbon toolbar

Markup and tokens

<div role="toolbar" aria-label="Quote tools">
  <div role="group" aria-label="Insert">
    <button><Icon name="plus" size={20} />Row</button>
    <button><Icon name="layers-1" size={20} />Section</button>
  </div>
  <div role="group" aria-label="Format">
    <button aria-pressed="true"><Icon name="bold" size={20} />Bold</button>
  </div>
</div>

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/RibbonPage.jsx

Tokens · click to copy

Ready · since v3.1Read the docs

Sidenav

Spec
Projects

Sidenav

Markup and tokens

<nav aria-label="Product" class="sidenav">
  <a href="/projects" aria-current="page">Projects</a>
  <a href="/quotes">Quotes</a>
</nav>

.sidenav { background: var(--sprout-layers-brand-surface);
  color: var(--sprout-layers-on-brand-surface); }
.sidenav [aria-current="page"] {
  color: var(--sprout-states-brand-surface-active);
  background: var(--sprout-states-brand-surface-active-background); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/NavigationPage.jsx

Tokens · click to copy

Ready · since v3.1Read the docs

Dialog

Spec
Focus is trapped. Esc closes.

Dialog

Markup and tokens

<div class="scrim">
  <div role="dialog" aria-modal="true" aria-labelledby="dlg-title">
    <h3 id="dlg-title">Delete quote Q-2041?</h3>
    <p>You can’t undo this.</p>
    <AceveButton variant="neutral" appearance="text">Keep quote</AceveButton>
    <AceveButton variant="danger">Delete quote</AceveButton>
  </div>
</div>

[role="dialog"] { background: var(--sprout-layers-overlay);
  box-shadow: var(--sprout-shadow-floater); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/DialogPage.jsx

Tokens · click to copy

Ready · since v3.4Read the docs

Drawer

Spec
Line 4 · Wall tiles 20×2032 m² · 18 400 kr
Edit line

Drawer

Markup and tokens

<aside class="drawer" aria-label="Edit line" data-open="true">…</aside>

.drawer { position: fixed; inset: 0 0 0 auto; width: 360px;
  background: var(--sprout-layers-overlay);
  box-shadow: var(--sprout-shadow-floater);
  transform: translateX(100%);
  transition: transform var(--sprout-motion-duration) var(--sprout-motion-ease); }
.drawer[data-open="true"] { transform: none; }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/PatternsPage.jsx

Tokens · click to copy

Beta · since v3.3Read the docs

Context menu

Spec
Right-click here, or use the menu button

Context menu

Markup and tokens

<div role="menu">
  <button role="menuitem">Rename <kbd>F2</kbd></button>
  <button role="menuitemcheckbox" aria-checked="true">Pinned to top</button>
  <button role="menuitem" class="danger">Delete</button>
</div>

[role="menu"] { background: var(--sprout-layers-overlay);
  box-shadow: var(--sprout-shadow-overlay);
  border-radius: var(--sprout-radius-md); }

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/ContextMenuPage.jsx

Tokens · click to copy

Beta · since v3.4Read the docs

AI disclosure label

React
AI-generated
Summary written with AIAIAI

AI disclosure label

Import

import { AceveAiDisclosureLabel } from '@/components/primitives';

Usage

{/* On an AI-generated image */}
<AceveAiDisclosureLabel variant="generated" placement="overlay" size={28} />

{/* Beside AI-written text */}
<AceveAiDisclosureLabel variant="basic" label="Summary written with AI" />

In the repo

Sourcecomponents/primitives/AceveAiDisclosureLabel.jsx

Tokens · click to copy

Ready · since v3.16Storybook Read the docs

Plan card + Confidence indicator

Draft
Before I start — here is the planAIAI
  1. 1Read 14 lines from the customer’s drawing
  2. 2Match each line to your price list
  3. 3Draft quote Q-2042 for you to review
Medium confidence — quantities were read from a photo, check them

Plan card

Markup and tokens

<section class="plan-card" aria-label="AI plan">
  <h3>Before I start — here is the plan</h3>
  <ol>
    <li>Read 14 lines from the customer’s drawing</li>
    <li>Match each line to your price list</li>
  </ol>
  <!-- confidence is always words, never a bare percentage -->
  <p class="confidence">Medium confidence — check the quantities</p>
  <AceveButton icon="play">Run plan</AceveButton>
</section>

No React primitive ships yet — build it from the tokens below.

In the repo

Speccomponents/pages/AiPatternsPage.jsx

Tokens · click to copy

PlannedRead the docs

In the hand

One app, three screens.

A field worker’s day on a folding phone and a watch, built from the components above. Everything here works — fold the phone, tick a task, pause the timer on the watch.

Cover screen — the drawing fills the screen, one sheet, tabs in thumb reach.
Loading the 3D model…
Loading the watch…
Guided tour

What the phone is made of

Press play, or pick a step: the phone moves into position and an arrow points at the component, colour or type style on the model. Each step lists its tokens and the SwiftUI for the same thing.

Drag to turn a device, double-click to reset. Tap the map or the drawing to drop a point. Phone model: “Apple iPhone Duo Fold Star White 2026” by UnknownOrigin on Sketchfab (Free Standard licence), a fan-made visualisation. Watch model: a third-party Apple Watch Series 4 download. Aerial photo © Beeldmateriaal Nederland, CC BY 4.0, via PDOK. Drawing: Historic American Buildings Survey, Library of Congress, public domain. Site photos: Wikimedia Commons, CC0 and public domain.

The iteration

What Sprout next changes.

Same components, same tokens, same accessibility rules. Five things move.

  1. 01Depth

    Surfaces are layered glass on the three Sprout elevation tokens — nothing floats without a shadow that says how high.

  2. 02Light

    A highlight follows the pointer across every card and control, so the interface answers before you click.

  3. 03Motion

    Sprout’s durations stay; the curve becomes a spring. Thumbs, tabs and sheets overshoot a little and settle.

  4. 04Shape

    Controls soften from 4–8px to continuous pills and 16px corners, sized for thumbs and for a watch face.

  5. 05Field

    A WebGL field behind the page is coloured by the live primary and link ramps — it changes when the tokens do.

Foundations

Tokens, live from the package.

Read from @aceve/sprout-tokens@0.1.3 at build time, in the current theme. Click any token to copy its CSS variable. Open the tokens repo

primary
danger
info
success
warning
neutral
link
Sprout · Aceve Design System · v3.35.0
Figma library GitLabReleases