Thoughtful React controls, built with Base UI and Tailwind CSS.
Every state planted, every edge case tended.
Install · Components · Theming · Develop · Contributing
Sprõut is a general-purpose component library from TulipFarm. It cares about the small things: busy, blocked, invalid, empty, and loading states, keyboard paths, and screen reader labels. The default theme is neutral, so it fits your product, not ours.
- Accessible by default. Built on Base UI primitives.
- Tailwind CSS 4 native. One CSS import. No JavaScript theme object.
- Tree-shakable. Every component has its own import path.
- Agent-ready. Chat, plan, tool, and review components for AI products.
- Light and dark. A neutral default and 15 more CSS theme presets.
Note
Sprõut is pre-1.0. APIs can change between minor versions.
Sprõut needs React 19 and Tailwind CSS 4.
pnpm add @tulipfarm/sproutInstall from GitHub instead of npm
Each GitHub release has the package tarball attached. No login needed:
pnpm add https://github.com/TulipFarm/sprout/releases/download/v0.1.0/tulipfarm-sprout-0.1.0.tgzThe package is also on GitHub Packages. It needs a GitHub token with
read:packages. Add this to .npmrc:
@tulipfarm:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}Add the styles to your CSS entry:
@import 'tailwindcss';
@import '@tulipfarm/sprout/styles.css';Use a component:
import { Button } from '@tulipfarm/sprout/button';
import { Badge } from '@tulipfarm/sprout/badge';
export function Status() {
return (
<>
<Badge variant="success">Connected</Badge>
<Button state={{ kind: 'busy' }} pendingLabel="Saving…">
Save
</Button>
</>
);
}The CSS entry registers Sprõut's classes with Tailwind. It does not change your body styles or generic shadcn tokens. Tailwind utility prefixes are not supported yet.
Each component imports from @tulipfarm/sprout/<name>, for example
@tulipfarm/sprout/dialog. See the component reference
for notes on each one.
Full library: 923.6 kB gzip. Each component path is smaller. Sizes are minified, with React and other peer dependencies left out.
Size of each component
| Component | Raw | Gzip | Brotli |
|---|---|---|---|
a2ui |
1400.5 kB | 429.6 kB | 354.7 kB |
a2ui/catalog |
52.3 kB | 18.3 kB | 16.4 kB |
accordion |
64.2 kB | 22.0 kB | 19.4 kB |
agent-fanout |
257.2 kB | 90.6 kB | 77.2 kB |
agent-avatar |
137.9 kB | 40.0 kB | 34.2 kB |
monster-avatar |
68.4 kB | 22.6 kB | 19.6 kB |
alert |
35.2 kB | 11.5 kB | 10.1 kB |
alert-dialog |
169.0 kB | 57.0 kB | 49.9 kB |
aspect-ratio |
30.3 kB | 9.7 kB | 8.5 kB |
attachment |
353.0 kB | 117.7 kB | 98.3 kB |
avatar |
44.0 kB | 14.6 kB | 12.9 kB |
badge |
35.0 kB | 11.5 kB | 10.0 kB |
board |
453.0 kB | 149.7 kB | 125.6 kB |
brand-icon |
195.2 kB | 70.2 kB | 61.2 kB |
breadcrumb |
40.5 kB | 13.4 kB | 11.7 kB |
button |
50.5 kB | 16.7 kB | 14.7 kB |
button-group |
38.0 kB | 12.1 kB | 10.7 kB |
calendar |
312.0 kB | 103.3 kB | 88.2 kB |
canvas |
235.1 kB | 80.6 kB | 69.2 kB |
card |
35.4 kB | 11.6 kB | 10.2 kB |
carousel |
60.4 kB | 19.9 kB | 17.5 kB |
chart |
593.4 kB | 169.2 kB | 138.9 kB |
timeline |
651.6 kB | 190.0 kB | 156.1 kB |
chat-confirmation |
76.6 kB | 26.1 kB | 22.3 kB |
chat-plan |
42.4 kB | 13.4 kB | 11.7 kB |
chat-sources |
206.1 kB | 70.9 kB | 60.4 kB |
chat-input |
987.8 kB | 327.9 kB | 269.8 kB |
chat-window |
287.0 kB | 95.4 kB | 80.1 kB |
checkbox |
60.0 kB | 21.0 kB | 18.5 kB |
choice-list |
43.0 kB | 14.5 kB | 12.6 kB |
code-block |
74.4 kB | 26.0 kB | 22.3 kB |
collapsible |
55.5 kB | 18.7 kB | 16.6 kB |
combobox |
268.6 kB | 90.9 kB | 77.6 kB |
command |
181.8 kB | 61.4 kB | 53.4 kB |
context-menu |
242.8 kB | 81.0 kB | 69.8 kB |
dialog |
170.6 kB | 57.5 kB | 50.2 kB |
direction |
1.5 kB | 0.8 kB | 0.7 kB |
dropdown-menu |
239.6 kB | 80.0 kB | 69.1 kB |
field |
98.0 kB | 34.1 kB | 29.6 kB |
file-explorer |
175.8 kB | 60.8 kB | 51.5 kB |
file-viewer |
321.7 kB | 108.6 kB | 91.0 kB |
form |
109.7 kB | 37.2 kB | 32.2 kB |
glass-banner |
33.0 kB | 10.7 kB | 9.4 kB |
gradient-banner |
32.2 kB | 10.3 kB | 9.1 kB |
hover-card |
163.2 kB | 56.3 kB | 49.1 kB |
input |
108.3 kB | 37.4 kB | 32.3 kB |
input-group |
119.1 kB | 40.4 kB | 34.7 kB |
input-otp |
65.4 kB | 23.0 kB | 20.4 kB |
kbd |
30.4 kB | 9.7 kB | 8.5 kB |
knowledge-base |
312.3 kB | 107.6 kB | 91.1 kB |
label |
30.2 kB | 9.6 kB | 8.4 kB |
mention-list |
52.7 kB | 17.3 kB | 15.2 kB |
menubar |
244.9 kB | 82.2 kB | 70.7 kB |
message |
36.2 kB | 11.7 kB | 10.4 kB |
message-actions |
210.1 kB | 73.4 kB | 61.9 kB |
message-response |
232.6 kB | 74.2 kB | 64.3 kB |
message-rich-text |
364.6 kB | 122.5 kB | 101.8 kB |
message-scroller |
69.0 kB | 22.1 kB | 19.6 kB |
metric |
31.2 kB | 9.9 kB | 8.7 kB |
model-selector |
271.9 kB | 96.6 kB | 82.5 kB |
navigation-menu |
182.4 kB | 62.9 kB | 54.7 kB |
notice-banner |
30.6 kB | 9.8 kB | 8.5 kB |
page-content |
30.2 kB | 9.6 kB | 8.5 kB |
page-header |
54.5 kB | 17.6 kB | 15.5 kB |
pagination |
55.2 kB | 17.9 kB | 15.6 kB |
plan-outline |
80.1 kB | 26.4 kB | 22.9 kB |
popover |
178.0 kB | 60.7 kB | 52.6 kB |
presence-cursor |
30.8 kB | 9.9 kB | 8.6 kB |
progress |
39.8 kB | 13.2 kB | 11.6 kB |
prompt-list |
199.1 kB | 71.9 kB | 62.6 kB |
questionnaire |
69.4 kB | 23.3 kB | 20.4 kB |
radio-group |
80.9 kB | 27.9 kB | 24.8 kB |
reasoning-effort |
35.5 kB | 12.0 kB | 10.6 kB |
record-list |
65.7 kB | 22.2 kB | 19.0 kB |
resizable |
39.4 kB | 13.4 kB | 11.8 kB |
result-card |
240.2 kB | 84.8 kB | 72.4 kB |
result-notice |
34.4 kB | 11.3 kB | 9.9 kB |
review-card |
61.7 kB | 21.0 kB | 18.4 kB |
rich-text-editor |
470.5 kB | 149.8 kB | 127.9 kB |
schema-diagram |
254.0 kB | 85.1 kB | 72.9 kB |
sql-viewer |
271.7 kB | 91.3 kB | 78.0 kB |
scroll-area |
57.4 kB | 19.7 kB | 17.4 kB |
search-dialog |
190.2 kB | 64.3 kB | 55.4 kB |
search-field |
122.1 kB | 41.3 kB | 35.4 kB |
select |
230.5 kB | 79.4 kB | 67.9 kB |
selection-slot |
31.5 kB | 10.2 kB | 8.9 kB |
separator |
37.0 kB | 11.9 kB | 10.5 kB |
settings-list |
31.1 kB | 9.9 kB | 8.7 kB |
sheet |
213.3 kB | 72.7 kB | 63.1 kB |
sidebar |
251.2 kB | 85.7 kB | 72.9 kB |
skeleton |
35.2 kB | 11.6 kB | 10.1 kB |
slider |
83.6 kB | 29.5 kB | 26.0 kB |
spinner |
36.6 kB | 11.6 kB | 10.1 kB |
state-panel |
553.8 kB | 181.9 kB | 149.5 kB |
state-sample |
33.5 kB | 10.5 kB | 9.2 kB |
status |
34.2 kB | 11.2 kB | 9.8 kB |
switch |
50.3 kB | 17.3 kB | 15.3 kB |
table |
541.3 kB | 172.8 kB | 145.8 kB |
table-nuqs |
2.1 kB | 1.1 kB | 1.0 kB |
tabs |
80.3 kB | 27.6 kB | 24.5 kB |
task-tree |
254.1 kB | 84.1 kB | 72.4 kB |
textarea |
98.3 kB | 34.2 kB | 29.6 kB |
toast |
189.5 kB | 65.3 kB | 56.7 kB |
toggle |
46.2 kB | 15.7 kB | 13.9 kB |
toggle-group |
67.2 kB | 23.1 kB | 20.4 kB |
tool-activity |
89.7 kB | 30.4 kB | 26.0 kB |
toolbar-status |
189.2 kB | 64.3 kB | 55.6 kB |
tooltip |
164.7 kB | 56.7 kB | 49.5 kB |
typed-text |
31.2 kB | 10.1 kB | 8.9 kB |
view-switcher |
270.1 kB | 90.6 kB | 77.1 kB |
web-source |
40.8 kB | 14.2 kB | 12.1 kB |
CI compares sizes on each pull request. Run pnpm size to see them locally.
| Group | Components |
|---|---|
| Actions | Button · Button Group · Toggle · Toggle Group · Toolbar Status · Kbd |
| Forms | Field · Form · Label · Input · Input Group · Input OTP · Textarea · Checkbox · Radio Group · Switch · Slider · Select · Combobox · Choice List · Calendar · Search Field · Rich Text Editor · Mention List · Questionnaire · Selection Slot · Reasoning Effort |
| Overlays | Dialog · Alert Dialog · Sheet · Popover · Hover Card · Tooltip · Dropdown Menu · Context Menu · Menubar · Command · Search Dialog · Toast |
| Layout & navigation | Sidebar · Navigation Menu · Breadcrumb · Pagination · Tabs · View Switcher · Accordion · Collapsible · Page Header · Page Content · Settings List · Card · Carousel · Resizable · Scroll Area · Separator · Aspect Ratio · Direction · Canvas |
| Feedback | Alert · Notice Banner · Badge · Progress · Spinner · Skeleton · State Panel · State Sample · Status · Task Tree |
| Data display | Table · Chart · Metric · Code Block · File Viewer · Schema Diagram · Avatar · Agent Avatar · Monster Avatar · Brand Icon · Attachment · Typed Text · Gradient Banner · Glass Banner |
| Agents & chat | A2UI Surface · Message · Message Actions · Message Response · Message Rich Text · Message Scroller · Chat Confirmation · Chat Plan · Chat Sources · Knowledge Base · Model Selector · Plan Outline · Prompt List · Result Card · Review Card · Tool Activity · Web Source |
Themes are plain CSS. Override any --sprout-* token:
:root {
--sprout-radius-control: 0.5rem;
}Presets live in @tulipfarm/sprout/themes/*: neutral, tulipfarm, github,
linear, vercel, stripe, notion, and more.
@import '@tulipfarm/sprout/themes/tulipfarm.css';The tulipfarm preset is the source of truth for every TulipFarm product. The
app and tulipfarm.ai read their colors from it, so change TulipFarm colors
there.
A shadcn registry item is at apps/docs/public/r/sprout.json. It works with
shadcn add (tested with shadcn 4.22.0). A public URL will come with the docs
release.
You need Node 22.22+ and pnpm 11.5.3.
pnpm install
pnpm dev # docs and live examples at http://localhost:4321After you change package code, run pnpm --filter @tulipfarm/sprout build.
After you change agent avatar artwork in packages/sprout/artwork/agent-avatars, run pnpm avatars.
pnpm build
pnpm typecheck
pnpm lint # Oxfmt check and Oxlint; `pnpm format` fixes formatting
pnpm test
pnpm exec playwright install chromium
pnpm test:browser
pnpm test:install # packs the library and installs it in a fresh appRun test commands one at a time.
sprout/
├── packages/sprout the published package and CSS themes
├── apps/docs Astro docs, live examples, shadcn registry
├── tests unit, browser, and packed-consumer tests
└── docs ADRs, plans, component reference
The docs deploy to Cloudflare Pages: build with pnpm build and serve
apps/docs/dist.
Contributions are welcome. Read CONTRIBUTING.md and the Code of Conduct. Report security problems privately, as described in SECURITY.md.
MIT © TulipFarm
Grown at TulipFarm,
one farm for every team's records, docs, agents, and workflows.