Skip to content
TulipFarmPublic

About

TulipFarm's component library for building next-gen web applications

Resources

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

163 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌱 Sprõut

Thoughtful React controls, built with Base UI and Tailwind CSS.

Every state planted, every edge case tended.

CI npm License: MIT Conventional Commits

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.

Install

Sprõut needs React 19 and Tailwind CSS 4.

pnpm add @tulipfarm/sprout
Install 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.tgz

The 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.

Components

Each component imports from @tulipfarm/sprout/<name>, for example @tulipfarm/sprout/dialog. See the component reference for notes on each one.

Bundle size

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

Theming

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.

shadcn

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.

Develop

You need Node 22.22+ and pnpm 11.5.3.

pnpm install
pnpm dev        # docs and live examples at http://localhost:4321

After 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 app

Run 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.

Contributing

Contributions are welcome. Read CONTRIBUTING.md and the Code of Conduct. Report security problems privately, as described in SECURITY.md.

License

MIT © TulipFarm


TulipFarm

Grown at TulipFarm,
one farm for every team's records, docs, agents, and workflows.

About

TulipFarm's component library for building next-gen web applications

Resources

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages