Frontend Academy · Les

Designtokens met Style Dictionary

Definieer tokens voor kleur, spacing en typografie in JSON en transformeer ze met Style Dictionary naar CSS-variabelen, JS-constanten of iOS-/Android-indelingen.

Les 2 van 414 stappen

Designtokens met Style Dictionary is een gratis Frontend Academy-les op CoddyKit. Dit is les 2 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Frontend Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Frontend Academy bevat in totaal 4 lessen.

Wat zijn ontwerptokens?

Ontwerptokens zijn de benoemde, primitieve waarden van een ontwerpsysteem: kleuren, tussenruimtes, lettergroottes, afrondingsstralen van randen en schaduwen. Ze vormen de bron van waarheid — elke component leidt zijn stijlen ervan af.

Waarom tokens belangrijk zijn

Tokens maken ontwerpbeslissingen onafhankelijk van de implementatie. Verander color.primary één keer van blauw naar groen en elke component die deze waarde gebruikt, wordt bijgewerkt. Je kunt er ook hetzelfde ontwerp mee leveren voor het web, iOS en Android.

Tokenopslag

Sla tokens op in JSON of YAML — een neutraal formaat dat door tools op verschillende platformen kan worden gebruikt. JSON komt het meest voor.

// tokens/color.json
{
  "color": {
    "brand": {
      "primary": { "value": "#2563eb" },
      "secondary": { "value": "#7c3aed" }
    },
    "text": {
      "default": { "value": "#111827" },
      "muted": { "value": "#6b7280" }
    }
  }
}

Style Dictionary

Style Dictionary (Amazon) is de feitelijke bouwtool voor ontwerptokens. De tool leest tokens en zet ze om naar meerdere uitvoerformaten: CSS-variabelen, SCSS, JS-constanten, iOS Swift en Android XML.

npm install -D style-dictionary

Configuratie

Maak style-dictionary.config.js waarin je de invoertokens en uitvoerplatformen beschrijft.

// style-dictionary.config.js
module.exports = {
  source: ['tokens/**/*.json'],
  platforms: {
    css: {
      transformGroup: 'css',
      buildPath: 'build/css/',
      files: [{ destination: 'tokens.css', format: 'css/variables' }]
    },
    js: {
      transformGroup: 'js',
      buildPath: 'build/js/',
      files: [{ destination: 'tokens.js', format: 'javascript/es6' }]
    },
    ios: {
      transformGroup: 'ios',
      buildPath: 'build/ios/',
      files: [{ destination: 'Tokens.swift', format: 'ios-swift/class.swift' }]
    }
  }
};

De build uitvoeren

Voer de CLI uit om alle platformen te genereren.

npx style-dictionary build

# Output:
# build/css/tokens.css     — CSS variables
# build/js/tokens.js       — JS constants
# build/ios/Tokens.swift   — Swift constants

Gegenereerde CSS-uitvoer

CSS-variabelen met een consistente naamgevingsconventie (kebab-case met naamruimte).

:root {
  --color-brand-primary: #2563eb;
  --color-brand-secondary: #7c3aed;
  --color-text-default: #111827;
  --color-text-muted: #6b7280;
}

Gegenereerde JS-uitvoer

JS-object voor gebruik in JS/TS-code (Tailwind-configuratie, CSS-in-JS).

export const ColorBrandPrimary = '#2563eb';
export const ColorBrandSecondary = '#7c3aed';
export const ColorTextDefault = '#111827';

Naamgevingsconventies voor tokens

Gebruik semantische namen (color.primary) in plaats van letterlijke namen (color.blue-500). Met semantische tokens kun je waarden wijzigen zonder namen te veranderen. Systeem met twee niveaus: letterlijk palet (blue-500) → semantische alias (primary).

{
  "color": {
    "palette": {
      "blue-500": { "value": "#2563eb" }
    },
    "brand": {
      "primary": { "value": "{color.palette.blue-500.value}" }
    }
  }
}

Thema's met tokens

Bouw meerdere platformen met verschillende invoerwaarden om thema's (licht/donker) te ondersteunen — dezelfde namen, verschillende waarden.

// Light theme:
--color-bg: white;
--color-text: black;

// Dark theme:
--color-bg: #111;
--color-text: white;

Tokencategorieën

Veelvoorkomende categorieën: color, spacing, typography (font-family, size, line-height, weight), border (radius, width), shadow, transition (duration, easing), z-index en breakpoint.

Tools voor tokenregisters

Naast Style Dictionary zijn er Tokens Studio (Figma-plugin), Specify en Supernova. Hiermee kunnen ontwerpers tokens in Figma beheren en automatisch met de codebasis synchroniseren.

Korte controle

Wat is het belangrijkste voordeel van ontwerptokens met Style Dictionary?

Beantwoord dit in de interactieve les

Samenvatting: ontwerptokens

Tokens zijn benoemde primitieve waarden (kleur, tussenruimte, typografie) — de bron van waarheid voor een ontwerpsysteem. Sla ze op als JSON. Style Dictionary zet ze om naar CSS-variabelen, JS, iOS en Android. Gebruik semantische namen (primary) in plaats van letterlijke namen (blue-500). Twee niveaus: palet → semantische alias. Thema's via afzonderlijke builds. Synchroniseer vanuit Figma met Tokens Studio.

Gratis beginnen

Leer HTML met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 41
Lessen: 163

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Designtokens met Style Dictionary” gratis?

Ja — de volledige tekst van “Designtokens met Style Dictionary” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Frontend Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Frontend Academy bevat in totaal 4 lessen.

Wat leer ik in “Designtokens met Style Dictionary”?

Definieer tokens voor kleur, spacing en typografie in JSON en transformeer ze met Style Dictionary naar CSS-variabelen, JS-constanten of iOS-/Android-indelingen. Je oefent met Frontend Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met Frontend Academy te beginnen?

Ervaring vooraf is niet nodig. Frontend Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.

Hoe lang duurt de les “Designtokens met Style Dictionary”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over Frontend Academy?

Ja. Elke les over Frontend Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

← Terug naar Frontend Academy