Design system voor je website: consistent en sneller bouwen
In dit artikel
Een design system is de vaste set bouwstenen en afspraken waarmee je website wordt gebouwd: kleuren, lettertypes en afstanden als vaste waarden, herbruikbare componenten zoals knoppen en kaarten, en regels voor wanneer je wat gebruikt. Het zorgt dat elke pagina er hetzelfde uitziet, dat een nieuwe pagina sneller klaar is en dat een AI-agent het systeem volgt in plaats van zelf iets te verzinnen. Ik leg dat systeem vast in de code en in de bouwafspraken van het project, zodat het na de oplevering niet uit elkaar groeit.
Wat is een design system?
Een design system is de bouwdoos van je website, inclusief de handleiding. Het bestaat uit drie dingen: vaste waarden voor kleuren, letters en afstanden, componenten die steeds opnieuw worden gebruikt, en regels die zeggen wanneer je wat inzet. Samen zorgen ze ervoor dat pagina twintig er net zo uitziet als pagina één, ook als die jaren later en door iemand anders is gemaakt.
Het begrip komt uit de wereld van grote digitale producten, waar tientallen ontwerpers en ontwikkelaars aan hetzelfde product werken. Zonder vaste afspraken krijgt elk scherm daar een eigen variant van dezelfde knop. Maar het probleem speelt ook op een gewone bedrijfssite. Wie na een paar jaar door zijn eigen website klikt, vindt vaak drie soorten knoppen, vijf grijstinten en koppen die op elke pagina net anders zijn.
Een design system is iets anders dan een huisstijl. Je huisstijl is de identiteit van je merk: logo, kleuren, lettertypes, beeldtaal en toon, voor alles wat je maakt, van visitekaartje tot bus. Een design system vertaalt die huisstijl naar bouwstenen voor je website of app. Wat er in een huisstijl hoort en wat die kost, behandel ik in huisstijl laten maken.
De drie lagen van een design system
Vaste waarden: design tokens
De basis zijn design tokens: ontwerpkeuzes met een naam. In plaats van overal een kleurcode te typen, wordt één keer afgesproken hoe die kleur heet. Dat gebeurt ook voor lettertypes, lettergroottes, afstanden, afgeronde hoeken en schaduwen. Zo ziet dat eruit in de code:
:root {
--kleur-primair: #0b6fb8;
--kleur-tekst: #1a1a1a;
--kleur-achtergrond: #ffffff;
--letter-basis: 1.125rem;
--letter-kop-groot: 2.5rem;
--ruimte-s: 0.5rem;
--ruimte-m: 1rem;
--ruimte-l: 2rem;
--hoek: 6px;
}
Elke knop, kaart en kop gebruikt daarna deze namen. Wordt het blauw iets donkerder, dan is dat één regel, en de hele site verandert mee.
Veel systemen werken met twee niveaus. Eerst de basiswaarden, zoals 'blauw-600'. Daarboven namen met een betekenis, zoals 'kleur-knop' of 'kleur-link', die naar een basiswaarde verwijzen. Dat lijkt dubbel werk, maar het maakt grote wijzigingen klein. Komt er later een donkere modus, dan krijgt 'kleur-tekst' in dat thema simpelweg een andere waarde. Wie die laag overslaat, merkt dat pas als zo'n wijziging opeens door honderd bestanden heen moet.
Componenten
Componenten zijn de onderdelen die op meerdere pagina's terugkomen: een knop, een kaart met foto en tekst, een formulierveld, een citaatblok, een blok met een oproep tot actie. Ze worden één keer gebouwd, met hun varianten, en daarna overal gebruikt. Het voordeel zit in het onderhoud: wordt de knop verbeterd, dan is hij op elke pagina meteen verbeterd.
Wat een leek niet ziet: een component is meer dan hoe hij er in rust uitziet. Een knop heeft ook een toestand als de muis erboven hangt, als hij de focus heeft via de Tab-toets, als hij is ingedrukt, als hij even moet laden en als hij niet beschikbaar is. Een formulierveld heeft een label, een lege en een ingevulde toestand, een foutmelding en een hulptekst. Elk van die toestanden moet genoeg contrast hebben, met het toetsenbord werken en op een smal scherm net zo goed passen als op een breed. Wie alleen de rusttoestand ontwerpt, laat de rest aan het toeval over.
Regels
Regels zeggen hoe de onderdelen worden gebruikt. Bijvoorbeeld: maximaal één primaire knop per sectie. Tussen twee secties altijd dezelfde ruimte. Koppen in een vaste volgorde. Foto's in kaarten altijd in dezelfde verhouding. Ook de teksten op knoppen horen hierbij; daarover gaat microcopy.
Toegankelijkheid hoort in de regels, niet erachteraan. Een systeem legt vast welke kleurcombinaties genoeg contrast hebben voor tekst, hoe de focusrand eruitziet en hoe groot een klikvlak minimaal is. WCAG 2.2 niveau AA is bij mijn sites het uitgangspunt, en dat staat in de bouwafspraken. Een systeem dat daarop is ingericht, maakt het lastig om per ongeluk een te lichte tekst of een te kleine knop te bouwen. Hoe contrast wordt gemeten en waar het misgaat, staat in kleurcontrast op je website.
Design system, huisstijl of component library: het verschil
De termen worden door elkaar gebruikt. Zo verhouden ze zich tot elkaar:
| Huisstijl | Design system | Component library | |
|---|---|---|---|
| Wat het is | De identiteit van je merk | Bouwstenen en afspraken voor je website of app | Een verzameling gebouwde onderdelen in code |
| Bevat | Logo, kleuren, lettertypes, beeldtaal, toon | Tokens, componenten, regels en documentatie | Knoppen, formulieren, menu's als code |
| Voor wie | Iedereen die namens het merk communiceert | Ontwerpers, bouwers en de codeer-agent | Bouwers |
| Vorm | Handboek, vaak een pdf | Code met uitleg erbij | Code |
| Voorbeeld | Ons blauw is #0B6FB8 | Gebruik --kleur-primair alleen voor knoppen en links | Een knopcomponent met drie varianten |
De huisstijl is de input. De component library is het deel van het design system dat al gebouwd is. Het design system zelf is het geheel, inclusief de afspraken die niet in code te vangen zijn.
Klein beginnen: zo pak ik een design system aan
Een design system hoeft geen maanden te kosten. Voor een bedrijfssite van tien tot dertig pagina's werk ik grofweg in deze volgorde:
- Inventariseren wat er al is. Bij een bestaande site loop ik eerst alle pagina's door en noteer ik de kleuren, lettergroottes en soorten knoppen die er rondzwerven. De uitkomst is vaak verrassend: negen grijstinten waar er drie genoeg zijn.
- De vaste waarden kiezen en toetsen. Een paar merkkleuren plus een korte reeks grijzen, vijf of zes lettergroottes en een reeks afstanden die logisch oplopen. Elke kleurcombinatie voor tekst toets ik meteen aan de contrastnorm, zodat er later niets hoeft te worden teruggedraaid.
- De componenten bouwen die het vaakst terugkomen, met al hun toestanden en voor elke schermbreedte. Meestal zijn dat de knop, de link, de kaart, het formulierveld en het sectieblok met kop en tekst.
- De regels opschrijven, per component: wanneer gebruik je hem, wanneer niet, welke varianten zijn er. Die regels komen ook in de bouwafspraken voor de codeer-agent.
- Losse waarden vervangen door tokens. Elke kleurcode of afstand die nog los in de code staat, gaat naar een token. Op een bestaande site zijn dat er al snel honderden, verspreid over tientallen bestanden. Dat omzetten laat ik door de codeer-agent doen. Welke waarde bij welk token hoort, bepaal ik, en elk aangepast bestand kijk ik na.
Niet alles hoeft in de eerste versie. Dit is een redelijke verdeling:
| Onderdeel | In versie 1 | Kan later |
|---|---|---|
| Kleuren en lettertypes als tokens | Ja | |
| Afstanden als tokens | Ja | |
| Knop, kaart, formulierveld | Ja | |
| Regels voor contrast en koppen | Ja | |
| Donkere modus | Als je die wilt aanbieden | |
| Iconenset | Als je iconen gebruikt | |
| Animaties en overgangen | Bij de eerste animatie | |
| Eigen documentatiesite | Pas bij meerdere sites of teams |
Is er nog geen ontwerp, dan begint het bij de opbouw van de pagina's. In wat is een wireframe lees je waarom de structuur eerst komt, voordat kleuren en componenten aan de beurt zijn.
Documenteren: zonder uitleg is het geen systeem
Een map vol componenten zonder uitleg is een rommelzolder met nette dozen. Pas als er staat waar iets voor dient, kan een ander er goed mee werken, of dat nu een collega is, een vervanger of een codeer-agent. Die uitleg hoort als gewoon tekstbestand naast de componenten. Dan verandert de documentatie mee met de code, in plaats van ergens in een vergeten map te verouderen.
Per component staat erin: het doel, wanneer je hem wel en niet gebruikt, welke varianten er zijn, waar je op let voor toegankelijkheid en welke tokens hij gebruikt. Zo ziet dat eruit:
Knop (primair) Gebruik: voor de belangrijkste actie in een sectie, zoals 'Afspraak maken'. Maximaal één per sectie. Niet gebruiken: voor een verwijzing in lopende tekst. Gebruik daar een gewone link. Varianten: primair, secundair, klein. Toegankelijkheid: klikvlak minimaal 24 bij 24 pixels, zichtbare focusrand, de tekst zegt wat er gebeurt. Tokens: --kleur-primair, --ruimte-m, --hoek.
Wil je zien hoe dit er op grote schaal uitziet, kijk dan naar NL Design System. Daar delen Nederlandse overheidsorganisaties open source componenten, richtlijnen en design tokens. Elke organisatie gebruikt dezelfde componenten en legt er haar eigen huisstijl als thema overheen. Dat is precies het idee achter tokens: de bouwstenen blijven gelijk, alleen de waarden verschillen.
Waarom AI-werk consistenter wordt met een design system
Een codeer-agent, een AI die zelf code schrijft en aanpast, is goed in het maken van iets dat er redelijk uitziet. Zonder systeem gokt hij. Vraag je om een nieuw blok met een knop, dan verzint hij een kleur die op je blauw lijkt, een afstand die ongeveer klopt en een knop die net iets ronder is dan de andere. Elke wijziging afzonderlijk valt nauwelijks op. Na twintig wijzigingen heb je een site die langzaam uit elkaar groeit.
Met een design system hoeft de agent niets te verzinnen. Hij gebruikt de bestaande knop en de bestaande tokens, net zoals een menselijke bouwer dat zou doen. Dat werkt alleen als het ook zo is opgeschreven. Daarvoor heeft elk project van mij een eigen bestand met bouwafspraken. Een design system maakt zulke afspraken concreet: niet 'gebruik onze blauwe kleur', maar 'gebruik --kleur-primair'. Een voorbeeld van zulke regels:
- Gebruik alleen kleuren, lettergroottes en afstanden uit tokens.css. Voeg geen nieuwe waarden toe zonder overleg.
- Bouw nieuwe onderdelen uit bestaande componenten. Is er geen passend component, stel dan eerst een nieuw component voor.
- Elke kleurcombinatie voor tekst haalt minimaal 4,5:1 contrast.
Welke andere afspraken in zo'n bestand thuishoren, bespreek ik in het bestand met bouwafspraken. Dat een agent beter overweg kan met code dan met de instellingen van een page builder, heeft dezelfde oorzaak: in code staat alles op één plek, leesbaar en doorzoekbaar. Een kleur die op twintig pagina's voorkomt, verandert met tokens in één keer. Zie ook page builder of code.
Hetzelfde principe werkt voor inhoud. Zet je gegevens als adres en openingstijden op één centrale plek, dan haalt elke pagina ze daar vandaan en klopt een wijziging overal tegelijk. Een design system doet dat voor de vormgeving.
Een systeem maakt controle ook makkelijker. Duikt er in een wijziging opeens een losse kleurcode op in plaats van een token, dan zie ik dat meteen in het verschil tussen de oude en de nieuwe versie. Zulke afwijkingen haal ik eruit voordat er iets live gaat; waar ik verder op let bij code van een agent, lees je in AI-code controleren.
Valkuilen: wanneer een design system tegenwerkt
Een design system is gereedschap, geen doel. Dit zijn de bekendste valkuilen:
- Te groot beginnen. Een documentatiesite met honderd componenten voor een website van acht pagina's. Het onderhoud kost dan meer dan het oplevert.
- Niemand is eigenaar. Als niemand het systeem bijhoudt, raakt het verouderd en gaat iedereen er weer omheen werken. Er moet één persoon zijn die nieuwe componenten goedkeurt. In mijn beheer ligt die rol bij mij: een nieuw onderdeel komt er pas bij als het in het systeem past.
- Te strak. Soms past inhoud niet in een bestaand component. Een uitzondering mag, maar wordt genoteerd. Komt dezelfde uitzondering vaker voor, dan is het tijd voor een nieuw component.
- Ontwerp en code lopen uit elkaar. Past de ontwerper in Figma een kleur aan en de bouwer niet, dan heb je twee systemen. Er moet vastliggen welke bron leidend is.
- Toegankelijkheid als laatste stap. Een systeem met te lichte grijzen of een weggepoetste focusrand verspreidt die fout over elke pagina. Een fout in het systeem is een fout op de hele site.
- Consistent lelijk blijft lelijk. Een design system zorgt dat keuzes overal gelijk worden toegepast. Het maakt een slechte keuze niet goed.
Het kost aan het begin wat extra tijd om waarden en componenten vast te leggen. Die tijd verdien je terug bij elke nieuwe pagina, elke campagne en elke wijziging, omdat de bouwstenen al klaarliggen en niemand meer hoeft te raden hoe iets eruit moet zien.
Conclusie: een design system houdt je site bij elkaar, ook na jaren
Een design system legt de keuzes van je website vast als bouwstenen: tokens voor kleuren, letters en afstanden, componenten voor wat steeds terugkomt, en regels voor het gebruik. Het idee is eenvoudig, het verschil zit in de uitvoering: toestanden die niemand ziet tot ze misgaan, contrast dat in het systeem zelf moet kloppen, en documentatie die meegroeit met de code. Goed ingericht blijft je site consistent, is een nieuwe pagina sneller klaar en heeft een AI-agent een kader in plaats van een vrijbrief. Ik richt dat in tijdens de bouw, en als vaste beheerder zorg ik dat het systeem bij elke wijziging heel blijft.
Hoe zulke afspraken er in de praktijk uitzien, laat bouwafspraken voor je codeer-agent zien. Wil je weten wat een website laten bouwen bij mij kost? Download de prijslijst.
Veelgestelde vragen
Wat is het verschil tussen een design system en een style guide?
Een style guide beschrijft hoe iets eruit moet zien: kleuren, lettertypes en het gebruik van het logo, vaak in een pdf of handboek. Een design system gaat een stap verder. Daarin staan dezelfde keuzes als vaste waarden in de code, plus de componenten die ermee gebouwd zijn en de regels voor het gebruik. Een style guide vertelt een bouwer wat de bedoeling is. Een design system levert de onderdelen waarmee hij het meteen goed bouwt. De style guide is daarom vaak een onderdeel van het design system.
Wat zijn design tokens?
Design tokens zijn ontwerpkeuzes met een naam. In plaats van overal de kleurcode #0B6FB8 te typen, spreek je af dat die kleur 'kleur-primair' heet. Hetzelfde doe je voor lettergroottes, afstanden, afgeronde hoeken en schaduwen. Verander je de waarde van een token, dan verandert die overal waar het token gebruikt wordt. Tokens staan meestal in een CSS-bestand of een JSON-bestand. Sinds oktober 2025 is er een eerste stabiele versie van een gezamenlijk bestandsformaat, opgesteld door de Design Tokens Community Group, een werkgroep die bij het W3C is ondergebracht. Daardoor wisselen ontwerp- en bouwtools tokens makkelijker uit.
Heeft een kleine website een design system nodig?
Een uitgebreid systeem met een eigen documentatiesite niet. Maar elke website, ook een van vijf pagina's, heeft baat bij de basis: een korte lijst met kleuren, lettergroottes en afstanden als vaste waarden, en een handvol componenten die steeds terugkomen, zoals een knop, een kaart en een formulierveld. Zonder die basis heeft een site na een jaar vaak zes tinten blauw en vier soorten knoppen. Die basis leg ik tijdens de bouw vast en houd ik daarna als vaste beheerder bij, zodat jij er zelf niets aan hoeft te onderhouden.
Welke tools gebruik je voor een design system?
Ontwerpers leggen kleuren, letters en componenten vaak vast in Figma, met variabelen voor de vaste waarden. In de code staan de tokens als CSS-variabelen of in een JSON-bestand. Grotere teams tonen hun componenten vaak in Storybook, een programma dat elk onderdeel los laat zien met al zijn varianten. Voor een bedrijfssite is dat meestal meer dan nodig: een afgeschermde pagina met alle componenten onder elkaar werkt ook. Welke vorm past, hangt af van wie het systeem gebruikt en bijhoudt. Bij een site van mij maak ik die afweging zelf, en de afspraken komen naast de code te staan.
Benieuwd hoe ik dit in de praktijk aanpak?
Het pitchdeck laat de hele werkwijze zien.
Geschreven door Dennis Boekhout
Marketing freelancer uit 's-Hertogenbosch. Volg op LinkedIn (opent in een nieuw tabblad)
