Skip to content

Document the CSS import and colour-scheme changes in the 3.0 migration guide #5203

Open
Open
Document the CSS import and colour-scheme changes in the 3.0 migration guide#5203
Milestone
[2026-Q2] Refine the EDS colour and token system 🎨

Description

@pomfrida
pomfrida
opened on Jul 20, 2026

Part of #4740 (consumer migration path, alongside #5121).

The 2.x → 3.0 migration guide must cover the consumer-facing consequences of ADR-0010 (#5199) and ADR-0013 (#5200):

  • The import line stays the same (@import '@equinor/eds-tokens/css/variables') while every variable name changes — the guide is the intended path for that rename
  • Automatic system-dark does not carry over: 2.x follows the OS via a prefers-color-scheme fallback; 3.0 is attribute-driven per ADR-0004. Apps that relied on the automatic behaviour must set data-color-scheme themselves (e.g. from a matchMedia listener)
  • Setup recommendation: set data-color-scheme server-side or in an inline <head> script to avoid a light flash before hydration
  • The new package README should be written around what the token system is (semantic tokens, attribute-driven theming, density) — not inherit the light-dark-heavy narrative from the 2.x README (see fix: emit explicit dark-scope rules instead of light-dark() in tokens #4864)

Done when the migration guide and the 3.0 package README cover the points above.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions