Extend future Basis tokens + update W3C DTCG format#35
Draft
jiromaykin wants to merge 2 commits into
Draft
Conversation
This was referenced Feb 5, 2026
3273a25 to
fd7463a
Compare
4064cea to
f9529af
Compare
5ab8b85 to
933c317
Compare
a42aec9 to
a6c8717
Compare
339bcd8 to
8ed18eb
Compare
3babcb6 to
6590cbd
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Our 'brand' directory must partially be renamed as 'common' as per this Slack NLDS discussion: https://codefornl.slack.com/archives/C01DAT4TRPF/p1771577384622079?thread_ts=1771512003.731269&cid=C01DAT4TRPF
the W3C token syntax is changing:
The draft Design Token Format drives the structure of these design tokens. To integrate with Figma we will be using the updated W3C DTCG format (sets a Dollar sign in its specified properties, like
$type,$value,$description,$deprecated,$extensions). Token and group names MUST NOT begin withthe
$character.Adding experimental Basis tokens for testing import in Figma.
In future we may be using the Theme Wizard (only for basisthema and startthema) to inherit from the Figma Basis tokens: https://theme-wizard.nl-design-system-community.nl/
Note there will be name differences: "volg NLDS naamgeving (danger→error, warning→danger)"
extra difficulty: OIP does nto have set values for main colors but uses an HSL variable so the colors wil work in our OIP color picker
Refactoring of OIP project variables necessary H"SL-variabelen in error: de originele CSS custom properties heetten --oip-color-danger-, maar nu zitten ze genest onder alerts.error. Variabelenamen zijn aangepast naar --oip-color-alerts-error- om consistent te zijn met de nieuwe structuur. Als Style Dictionary die namen automatisch genereert vanuit de JSON-paden, klopt dit — maar als je ergens in je CSS al --oip-color-danger-h gebruikt, moet dat nog veranderd worden. "
More Documentation:
https://nldesignsystem.nl/handboek/huisstijl/themas/start-thema/
Example of Basis tokens: https://www.figma.com/design/FqAr99wvrlHxTJYAHkFRQN/NL-Design-System---Bibliotheek?node-id=22161-58828&t=HoYMBSXYkEc1RtBr-1
If everyone uses the the same Basis theme in future, it will be much easier to change 'huisstijl' and for all municipalities to use the same structure for design-tokens.
Layout changes: token names are now quite different:
Issue References
Checklist
package.jsonand inpackage-lock.json(can also be done after merge withnpm version ...)