Release
Pre-release checklist
-
Build succeeds
Terminal window pnpm build -
All tests pass
Terminal window pnpm testpnpm test:parity -
i18n check passes
Terminal window pnpm i18n:check -
Figma sync is up to date
Terminal window pnpm figma:sync:dry # verify no unexpected diffspnpm figma:sync -
Docs are regenerated
Terminal window node packages/tokens/scripts/docs.mjspnpm i18n:report
Version bump
Update the version in packages/tokens/package.json following semver:
| Change | Version bump |
|---|---|
| New primitive color palette | minor |
| New semantic token | minor |
| New component token | minor |
| Value change (existing token) | patch |
| Breaking rename or removal | major |
Generated outputs
A release produces these artifacts:
| Output | Path | Consumer |
|---|---|---|
| CSS tokens | dist/css/tokens.css | Storefront (Astro/Svelte) |
| CSS brand overrides | dist/css/getplants.css | Storefront theme layer |
| Dart tokens | dist/dart/verdanta_tokens.dart | Flutter app |
| Figma variables | dist/figma/variables.*.json | Figma Variables API |
| Tailwind preset | dist/tailwind-preset.mjs | Storefront Tailwind config |
| Token docs | docs/.../tokens/reference.md | Design system docs |
| i18n status | docs/.../localization/status.md | Design system docs |