@usefidel/design-system
v0.11.1
Published
Fidel brand design tokens + React component library — DTCG token source of truth, generated per-surface CSS + Tailwind-v4 parser-compatibility output, and on-brand React components (Button, MismatchCard, DiffSection).
Readme
@usefidel/design-system
The single source of truth for Fidel's brand design tokens.
tokens/tokens.json— DTCG ($value/$type). The only source of truth. Change a color here, nowhere else.tokens/CLASSIFICATION.md— how every migrated value was classified (canonical / legacy-alias / surface-transform / delete-replace).dist/*.css— generated per-surface CSS. Do not edit by hand.dist/theme.css— generated Tailwind v4@themeparser-compatibility output. It exists so Fidel's owntheme-intakeparser (which reads Tailwind, not raw DTCG) can ingest our brand. It is a compatibility layer, NOT a second source of truth. Native DTCG parsing is a separate follow-up.dist/fidel.manifest.json— version boundary:{ brandKey, tokenSource, generatedCssOutputs, storybookUrl, packageVersion, resolvedSha }.
Surfaces (webapp / extension / landing / admin) are outputs of the one Fidel brand, not separate brands. Per-surface density is a declared Style Dictionary platform dimension.
Build
npm ci && npm run build regenerates all of dist/.
