Clean, organic and unmistakably Brazilian.
English · Português
The ipê is a Brazilian tree that blooms in bright yellow during the driest months of the year. This design system borrows that idea: a calm, solid foundation that still carries color.
Pure white and pure black backgrounds, with strong Brazilian colors that carry the brand: passion-fruit yellow, forest green, urucum and indigo.
- Design tokens as the single source of truth. Tokens live in
/tokens, sync with Figma through Tokens Studio, and are compiled by Style Dictionary into CSS variables. The CSS variable names match the code syntax set on every Figma variable. - Light and dark themes driven by semantic tokens, following
prefers-color-schemeor adata-themeattribute. - Accessible by default. Every color pair is checked against WCAG 2.2, including the 3:1 rule for form-control borders. Components are tested with keyboard interaction and axe-core.
- Bilingual documentation. Storybook switches every story between English and Portuguese, and between light and dark, from the toolbar.
- Works with or without Tailwind. Ships plain CSS plus an optional Tailwind CSS v4 theme preset.
- Real-world patterns. A complete, validated sign-up form built only with Ipê components lives in Storybook under Patterns.
- Tested in a real browser on every pull request. Every story runs in Chromium, in light and dark, with its interaction test and an axe-core audit including color contrast. See ACCESSIBILITY.md.
- QA cycle documented. A test plan, 24 test cases and 6 bug reports with before and after evidence live in
/qa. Every fix shipped with a regression check.
npm install @rayssarrsilva/ipeimport '@rayssarrsilva/ipe/styles.css';
import { Button } from '@rayssarrsilva/ipe';
export function App() {
return <Button onClick={() => alert('🌱')}>Plant a seed</Button>;
}Load the fonts once in your app (both are free on Google Fonts):
<link
rel="stylesheet"
href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght,SOFT@9..144,300..700,0..100&family=Instrument+Sans:wght@400..700&display=swap"
/><html data-theme="dark"></html>Without the attribute, Ipê follows the operating system preference.
@import 'tailwindcss';
@import '@rayssarrsilva/ipe/tokens.css';
@import '@rayssarrsilva/ipe/tailwind.css';Then use the tokens as utilities: bg-action-primary, text-text-secondary, rounded-pill, shadow-md.
import { lightTokens } from '@rayssarrsilva/ipe/tokens';| Component | Status |
|---|---|
| Button | ✅ |
| Input, Textarea, Checkbox, Switch, Badge | ✅ |
| Dialog, Toast, Tabs, Dropdown, Tooltip | ✅ |
React 19 · TypeScript · Vite (library mode) · Radix UI primitives · CSS Modules · Style Dictionary + Tokens Studio · Storybook 10 · Vitest + Testing Library + axe-core · ESLint + Prettier · Husky + commitlint (Conventional Commits) · Changesets · GitHub Actions
Requires Node.js 22 (see .nvmrc).
npm install
npm run dev # Storybook at http://localhost:6006
npm test # unit and accessibility tests (jsdom)
npm run test:storybook # every story in real Chromium, light and dark
npm run test:coverage # with coverage thresholds
npm run lint
npm run typecheck
npm run build # library output in /dist
npm run check:package # publint + Are The Types Wrong
npm run test:smoke # install the packed library into a fresh React app and build it- Edit tokens in Figma with Tokens Studio, or directly in
/tokens. - Run
npm run tokensto regenerate the CSS variables and the TypeScript token list.
- Branch from
main, open a pull request, and wait for CI to pass.mainis protected. - Commit messages follow Conventional Commits and are checked by commitlint.
- Run
npm run changesetto describe changes to the published package. Merging the release pull request publishes to npm and updates the changelog.
Made with care by Rayssa Roberta · LinkedIn · Portfolio
Feedback, issues and pull requests are very welcome.