Skip to content

feat(styles)!: build on ig-design-system and read its semantic tokens - #195

Draft
desig9stein wants to merge 13 commits into
masterfrom
mpopov/adopt-design-system-tokens
Draft

desig9stein wants to merge 13 commits into
masterfrom
mpopov/adopt-design-system-tokens

Conversation

@desig9stein

@desig9stein desig9stein commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

The package builds on the Infragistics design system: DocsLayout loads it as the base, and every component reads its tokens. One system then serves the docs, the API docs, the blog and the marketing site.

  • DocsLayout loads src/styles/design-system/ (fonts.css, tokens.css, theme.css) before theme.scss and sets data-igd-type="docs" on <html>. The folder is a copy of the built ig-design-system package at 17e4b6f; node scripts/sync-design-system.mjs refreshes it.
  • The hand-made palette (_palette.scss, 485 lines), the type scale (_type-scale.scss) and the Material elevations are removed. The engine variables (--ig-primary-500, --ig-h1-font-size, --ig-elevation-4) come from the design system. Type styles keep their bottom margins in _type.scss.
  • No stylesheet reads a raw palette step. Text, surface and border colours are --igd-color-* tokens; callouts, Do and Don't, the icon gallery and the copy tick read feedback tokens; the status badges read badge tokens. light-dark() calls go from 158 to 5, none of them a palette colour.
  • 142 padding, margin, gap and radius values read --igd-space-* and --igd-radius-* tokens. Widths, heights and offsets stay as typed: they are not part of the design system.
  • --igd-accent, --igd-on-accent, --igd-link-color, --igd-link-hover-color, --igd-app-bg, --igd-on-app-bg, --igd-app-outline-color, --igd-font-sans, --igd-padding-sm/md/lg and the status badge names keep their names and point at design system tokens.

This is a draft. The design system is not published yet, so it is a copied folder and not a dependency.

Related issue

No issue

Type of change

  • Styles / theming / tokens
  • Breaking change (consumer sites must change something — say what under Consumer impact)

How to test

  1. npm run playground, open http://localhost:4567.
  2. npm run format:check, npm test, npm run lint, npm run playground:check, npm run playground:build.

Results: 221 tests pass; lint, playground check (0 errors) and playground build (33 pages) pass; format:check passes for tracked files.

Measured in Chromium on 16 playground pages in the light theme, every element's computed font, size, weight, box size, radius, padding and colours, against master:

  • No element changes font size or weight. 3 of 16 pages keep their height; the others change by -22px to +102px, from the wider faces and the 24px block rhythm.
  • The corner radius goes from 4px to 6px, the design system's smallest. The block rhythm goes from 26px to 24px.
  • Grays: the blue-tinted Tailwind grays become the design system's neutral grays, a few units apart (heading text #101828 becomes #16181b). The accent stays #155dfc. Borders that used gray 300 are one step lighter; borders that used gray 400 are darker and meet 3:1.
  • Do is green (#06633c, 7.35:1) and Don't is red (#cf1b3e, 5.41:1). Warning callouts are amber; they were orange, the old secondary colour.
  • The compiled playground CSS is byte-identical with igniteui-theming 29.0.0 and 30.2.0.

The dark theme was not reviewed. Nobody is working on it and the sites have no switch for it yet.

Consumer impact

  • Fonts change. Body text is DM Sans and headings are Plus Jakarta Sans, from the design system. A site that wants another face sets --igd-font-body or --igd-font-display itself.
  • Secondary is violet, not orange. The FAQ indicator, one Markdown highlight and the search gradient change with it, and so does anything a host site styled with --ig-secondary-*.
  • Palette steps change value. --ig-primary-600 was the accent #155dfc and is now #2462ea; the accent is --igd-accent. The high steps run darker: --ig-success-900 was a green and is near-black.
  • Corners are 6px where they were 4px, and block spacing is 24px where it was 26px.
  • Removed Sass: $igd-type-scale is no longer forwarded from styles/global, and $light-palette / $dark-palette are gone.
  • --igd-font-mono is the design system's stack ('JetBrains Mono', ui-monospace, monospace).
  • Peer dependency igniteui-theming accepts ^29.0.0 || ^30.2.0. The dev dependency moves to 30.2.

Notes for the reviewer

  • src/styles/design-system/ is generated output from another repository and is in .prettierignore. Do not review it line by line.
  • Stays as typed: widths, heights and offsets; 18 spacing and radius values off the scale; the code block colours from the Shiki theme. GlobalNavBar still names aktiv-grotesk, so the Typekit link stays.
  • Judgment calls worth a look: tooltips use color-surface-inverse and color-text-inverse; the tree item hover background uses color-surface-muted; the "Open source" badge is neutral gray so it differs from the green "New"; "Preview" is amber because the palette has no orange.
  • DESIGN_SYSTEM_ADOPTION.md is a working report with the inventory. Remove it before merge.

- DESIGN_SYSTEM_ADOPTION.md records how the styles here compare with ig-design-system: tokens, palette, type, spacing, dark mode and the Ignite UI components in use.
- It lists eight gaps to raise in ig-design-system and four questions for the owner.
- No component or style is changed.
… a page

- A button in the bottom left corner, or ?ds=on in the URL, loads the design system's tokens.css and theme.css after every other stylesheet.
- playground/public/design-system holds a copy of the built package; sync-design-system.mjs refreshes it from a sibling checkout.
- DESIGN_SYSTEM_ADOPTION.md records what changes when the switch is on and what the trial found.
- Nothing under src/ changes.
- The switch sets data-igd-type="docs" on the page, and the copy of the design system is refreshed to a build with base.css split out, no dials and the docs type set.
- DESIGN_SYSTEM_ADOPTION.md records the trial again: headings, paragraphs, heading spacing, link underlines and the Ignite UI control size match the page as it is today.
- The trial loads ig-design-system 86e6740, whose default type, spacing, radius and shadow values follow the marketing site.
- The docs type set is unchanged, so the playground with the switch on still differs from today only in font family.
…ions

- DocsLayout loads the design system (src/styles/design-system, a copy of the built package at 86e6740) before theme.scss and selects its docs type set.
- The hand-made palette, the type scale and the Material elevations are removed; the engine variables come from the design system.
- Type styles keep their bottom margins, and detail-1 and detail-2 read the design system's body-xs and body-2xs.
- The playground trial switch is removed.
- No stylesheet reads a raw gray step: text, surface and border colours are --igd-color-* tokens, with one value per theme and no light-dark() pair.
- --igd-accent, --igd-on-accent, --igd-link-color, --igd-link-hover-color, --igd-app-bg, --igd-on-app-bg, --igd-app-outline-color, --igd-font-sans and --igd-padding-sm/md/lg keep their names and point at design system tokens.
- Warning callouts read the warning palette, not secondary.
- igniteui-theming 30.2 is accepted beside 29; the compiled playground CSS is the same with both.
- README, llms.txt and AGENTS.md describe the design system and the semantic colour rule.
@desig9stein desig9stein changed the title chore(playground): add a switch that loads ig-design-system on top of a page feat(styles)!: build on ig-design-system and read its semantic tokens Nov 16, 2026
- The success palette is built from green #028a54, so the Do frame and the copied state stay green.
- The Do accent reads success-600 (light) and success-200 (dark); the Don't accent reads error-500 (light) and error-300 (dark).
- The design system's ramps run darker at the high steps, so success-900 was near-black and error-700 maroon.
- Label contrast: 7.35:1 and 5.41:1 on the light page, 8.25:1 and 6.07:1 on the dark page.
…steps moved

- Warning callouts are amber in both themes: text reads warn-500 and warn-600 on warn-50 (4.57:1 and 6.19:1), and warn-200 and warn-100 on warn-800 in the dark theme.
- The dark info callout title reads primary-300 (5.56:1); it was 4:1.
- The note callout's code chip reads color-surface-subtle; its light value named a variable that does not exist and its dark value was a secondary step.
- The copied tick on a code block reads success-400.
- Sample and icon gallery backgrounds read color-surface-page and color-surface-card.
- New, Updated, Preview and Premium read the design system's badge tokens; Open source reads neutral text, surface and border tokens.
- 15 typed-in light and dark colour pairs are removed.
- The design system copy is e240e7d.
- No stylesheet reads a raw palette step. Callouts, Do and Don't, the icon gallery, links, chips and the copy tick read feedback, action, tint and accent tokens.
- DocsLayout loads the design system's optional fonts.css; the font rules left tokens.css.
- light-dark() is left in 5 places that are not palette colours: the logo type, two shadows, a shimmer and a transparent sample background.
- The design system copy is 17e4b6f.
…tem tokens

- 131 padding, margin and gap values on the spacing scale read space-inset, space-stack and space-gap tokens, with no change in size.
- The 26px block rhythm reads space-stack-xl, so it is 24px.
- The 4px corner radius reads radius-xs, so it is 6px; 8px reads radius-sm.
- Widths, heights, offsets and 18 values off the scale stay as typed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant