Skip to content

Release

Pre-release checklist

  1. Build succeeds

    Terminal window
    pnpm build
  2. All tests pass

    Terminal window
    pnpm test
    pnpm test:parity
  3. i18n check passes

    Terminal window
    pnpm i18n:check
  4. Figma sync is up to date

    Terminal window
    pnpm figma:sync:dry # verify no unexpected diffs
    pnpm figma:sync
  5. Docs are regenerated

    Terminal window
    node packages/tokens/scripts/docs.mjs
    pnpm i18n:report

Version bump

Update the version in packages/tokens/package.json following semver:

ChangeVersion bump
New primitive color paletteminor
New semantic tokenminor
New component tokenminor
Value change (existing token)patch
Breaking rename or removalmajor

Generated outputs

A release produces these artifacts:

OutputPathConsumer
CSS tokensdist/css/tokens.cssStorefront (Astro/Svelte)
CSS brand overridesdist/css/getplants.cssStorefront theme layer
Dart tokensdist/dart/verdanta_tokens.dartFlutter app
Figma variablesdist/figma/variables.*.jsonFigma Variables API
Tailwind presetdist/tailwind-preset.mjsStorefront Tailwind config
Token docsdocs/.../tokens/reference.mdDesign system docs
i18n statusdocs/.../localization/status.mdDesign system docs