UX-essay · Systeemontwerp

Een design system leeft alleen als het als code wordt gebruikt

Ik heb sinds 2017 bij elk bedrijf waar ik werkte een designsystem gebouwd. Eén verschil bepaalde welke nog in gebruik waren nadat ik vertrok: of de bibliotheek in het product was gecompileerd, of als document was opgeborgen om te raadplegen. Deze pagina loopt het proces door met Findhotel als voorbeeld, en laat daarna zien wat de andere systemen opleverden.

6
Bedrijven, één methode, 2017 tot vandaag
9
Regels waaraan een component moest voldoen vóór publicatie
6
Mensen in het Findhotel-team, vier van hen ontwikkelaars
Klanten
Rol UX Designer, en daarmee automatisch product owner van het system
Team Bij Findhotel: 4 front-end developers, één uit elk productteam, en 2 designers, op een kanbanbord zonder product owner
Doorlooptijd Coolblue 2017, Floorplanner 2018, Maersk 2019, Findhotel 2020, en daarna Zimmer Biomet 2021 en TrackBee 2025
Platform Componentbibliotheken achter webproducten, op desktop en mobiel
Tools Sketch, Figma, Zeplin, InVision, Abstract, Storybook, Chromatic, Claude Code
Een pagina uit de stijlgids met tekstvelden van één regel in elke status, primaire en secundaire knoppen, sliders en een rij iconen
Voorbeeld uit het design system van Floorplanner. Een tekstveld kan meerdere varianten hebben, afhankelijk van de status.

Probleem

Niemand besluit om vier verschillende knoppen te bouwen

In een bedrijf van elke omvang zitten designers bij productteams, om goede redenen: elk leert het probleem van dat team kennen en levert op diens roadmap. De kosten komen later. Zet de schermen van twee teams naast elkaar en de verschillen zijn duidelijk.

Het gebeurt op elke schaal: een letterstijl die één stap afwijkt, een grijs dat uit een screenshot is geprikt, of een hele flow die gebouwd werd omdat het ene team niet kon weten dat een ander het al had opgelost.

Dit is geen kwaliteitsprobleem. Elk scherm is zorgvuldig gemaakt door iemand die zijn vak verstaat. De inconsistentie komt voort uit hoe de teams georganiseerd zijn, dus de oplossing moet ook de organisatie veranderen. Een document dat designers vraagt consistent te zijn, is alleen een verzoek.

Daarom bouw ik geen stijlgids. Ik bouw een plek waar designers en de front-end developers die om gebruikerservaring geven het eens worden over een gedeelde taal, en een route die wat ze afspreken onderdeel maakt van het product.

Doelen

Wat een system moet doen om de sprint waard te zijn

Consistentie die de klant voelt
De klant opent de bibliotheek nooit. Hij heeft er baat bij omdat een knop op elke pagina hetzelfde is, dus er valt niets opnieuw te leren.
Open genoeg om bewerkt te worden
Developers, copywriters en product owners hebben allemaal iets te zeggen over hoe een component zich gedraagt. Als alleen designers hem kunnen bewerken, werken de anderen eromheen.
Gecompileerd, niet geraadpleegd
Verander de stijlgids en de producten veranderen mee. Als de een de gids leest en de ander hem opnieuw intypt, groeien de twee uit elkaar.
Verdieping

Wie de bibliotheek gebruikt

Developers, designers, copywriters, product owners

De begunstigde is de klant. De gebruikers zijn vier groepen binnen een bedrijf.

Front-end developers
De groep die bepaalt of er iets van echt is. Zij hebben een component nodig die ze kunnen importeren, geen specificatie die ze moeten interpreteren.
Designers
Zij moeten een component van de plank kunnen pakken en erop kunnen vertrouwen, inclusief het vertrouwen dat iemand anders hun werk kan bewerken zonder dat het uit elkaar valt.
Copywriters
Degene die het meest consequent wordt vergeten. Woordlengte, toon en zinsvorm zijn eigenschappen van een component, en een component die alleen in het Engels op een comfortabele lengte is gemaakt, is een component die waarschijnlijk breekt.
Productverantwoordelijken
Zij moeten zien wat er al is voordat ze iets inplannen dat niet gebouwd hoeft te worden, en dat is de goedkoopste besparing van de hele exercitie.

Team & publiek

Eén sprint van de vier, en geen product owner

Wat voor mij het best werkte, is een geleend team in plaats van een vast team: een designer en een front-end developer uit elk productteam, die op een vast schema samenkomen.

Drie sprints lang werkt iedereen aan het eigen product en loopt tegen ontbrekende dingen in de bibliotheek aan. De vierde sprint begint met een rij echte behoeften, geen verlanglijst die in een vergaderruimte is bedacht.

Bij Findhotel bestond het team uit zes mensen: vier front-end developers, één uit elk productteam, en twee designers. We werkten met een kanbanbord en hadden geen product owner.

Scope en beperkingen

Wat geen experiment nodig had

Bijna niets van dit werk werd getest, en dat was de juiste keuze. Twee belangrijke beslissingen maakten het grootste deel ervan uit, en geen van beide is het soort vraag dat een experiment kan beantwoorden.

Het eerste is het verwijderen van een variatie die niemand heeft gekozen. Als een product drie grijstinten heeft waarvan twee teams er elk één hebben verzonnen en niemand kan zeggen waar de derde voor dient, dan is ze samenvoegen geen hypothese. Er is geen uitkomst denkbaar die pleit voor het behouden van een ongelukje.

Het tweede is het toepassen van richtlijnen die al bestaan en beter onderbouwd zijn dan alles wat wij zelf zouden kunnen uitvoeren. Contrastverhoudingen zijn het duidelijkste geval: W3C heeft het werk al gedaan, op een steekproefgrootte die geen enkel bedrijf zelf bereikt, en dit lokaal opnieuw testen om te zien of onze gebruikers ook liever dingen kunnen lezen, zou theater zijn.

Wanneer een verandering echt een vraag was, verliet die dit team. Die ging naar het productteam dat die flow bezat, waar een product owner was om het te prioriteren en een data scientist om de test te ontwerpen.

Proces

Zes stappen, en de eerste drie zijn politiek

De volgorde is belangrijk. Drie van deze zes gebeuren voordat er ook maar één component is gemaakt, en ze overslaan is hoe een design systeem een map wordt die iemand ooit heeft gemaakt.

01

In kaart brengen wat er al is

Een inventarisatie vóór een voorstel. Kleuren, tekstvelden, lettertypefamilies, toggles, sliders, popups, knoppen, splitknoppen, galerijen, en elke variatie daarvan die het product bleek te bevatten.

Het resultaat is de lijst, uitgetekend. Over een telling van dertien knopstijlen kun je discussiëren. Over dertien knoppen op drie slides niet.

Bij Findhotel komt de primaire knop drie keer voor, in drie verschillende tinten blauw: #3979F5 op de knoppenslide, #0074F8 in de header, #4476FB in de dialogen. Niemand koos er bewust drie.

Knoppen

13
Search
Primaire knop
Filter by
Secundaire knop
Reset
Subtiele knop
Go back to search
Linkknop
Unlock Deal
Knop voor privédeal
Veldknop met icoon
Show details
Accordeonknop
EN€
Knoppenrij
English
Knop met icoon en tekst (lijststijl)
Delft
Ankerknop
Icoonknop
9+
Wisselknop
Best match
Keuzerondje
  • #3979F5Knoppenslide, Search
  • #0074F8Headersectie, Search
  • #4476FBDialog, Back to form

Eén primaire knop, drie tinten blauw.

Verdieping

De rest van de catalogus

43 componenten

Formulier

13
First name *
Leeg invoerveld met placeholder
Taipei City
Tekstinvoer ingevuld met wisoptie
Leeg tekstinvoerveld met knop
e.g. city, region or hotel
Taipei CityTaiwanDec 15 - Dec 16, 2 GuestsCity
Taipei CityTaiwanNov 24 - Nov 25, 2 GuestsCity
Tekstinvoer met automatisch aanvullen
Taipei City
Taipei CityTaiwanDec 15 - Dec 16, 2 GuestsCity
Taipei CityTaiwanNov 24 - Nov 25, 4 GuestsCity
Ingevulde invoer met automatisch aanvullen
Choose a bed type1 double bed2 single beds1 double bed and 1 sofa bed2 double beds1 king bed1 twin bed
Selectieveld
Tue, Jan 21January 2020 ›MoTuWeThFrSaSu1314151617181920212223242526
Datumveld
Telephone number *This does not look like a valid phone number
Foutmelding bij een leeg invoerveld
Requests (optional)
Tekstvak
Hotel
Selectievakje
Expiration MM/YY *12/19
Invoerveld met masker
Telephone country code *Netherlands +31
Volledige invoer met validatie
Telephone number *0654331553You may be reached at: +31 654331553
Leeg invoerveld met informatie

Weergave

9
The price for this hotel has dropped today
Tooltip
Private deal unlocked8.3Efficient check-in/check-out
Labels
Sterren
Couples50%
Voortgangsbalk
Laadindicator
Searching all the best travel sites
Toastmelding
We use cookies. Continue browsing if you are okay with that.
Overlaybanner
Unfortunately the price has changed.The price raised from €181.72 to €182.00Secure bookingIt takes only 2 minutesThe deal you chose is no longer availableWe found you these other great deals
Ingebedde banner
Property TypeHotel854Apartment212Guest house63Hostel29Bed and breakfast11Inn4Show more
Filteropties

Containers

8
Movenpick Hotel AmsterdamOostelijk Havengebied8.8FabulousBooking.com€111View DealACCOR€111€105View Deal
Kaart
Check in/Check outCheck in from 15:00Check out prior to 12:00GeneralPaymentHouse rules
Uitklappaneel
Booking.com€141View Deal
Klikbare rij met hover-effect
Option 1Free cancellation↑ Before Mon, Jan 20€123Reserve
Rij
Booking.com€92View DealExpedia€94View DealHotels.com€94View Deal
Rijlijst
Scheidingslijn
FINDHOTELEN€
Kopsectie
Voettekstsectie

Afbeeldingen

Avatar
Miniatuurafbeelding
Afbeelding met één ronde hoek
Afbeelding met ronde hoeken
1/49
Afbeelding

Menu's

FINDHOTELEN€EnglishEspañolFrançaisPortuguêsItalianoDeutschNederlandsPolskiTürkçeSvenskaDanskNorskSuomiČeštinaMagyarRomânăHrvatskiSlovenščinaEestiLatviešuLietuviųFilipinoMelayuSlovak
Vervolgkeuzemenu
PreferencesEnglish (en)Euro (€)About UsPrivacy PolicyHotels FAQContact
Hamburgermenu
AmsterdamCheck InTue, Jan 212 Guests, 1 RoomCloseSearch
Uitschuifmenu

Navigatie

View on Google Maps
Link
Linklijst
PhotosDetailsLocationReviewsDeals
Tabbladen

Overlays

FINDHOTELEN€Sold out on your datesLooks like there are no longer any rooms available for the dates you selected.Back to previous page
Pagina-overlay
Payment failedSorry, we could not process your payment. Please try again.Back to formCustomer Support
Dialoogvenster
02

De tijd vrijkopen

Met de inventarisatie in de hand gaven een lead developer en ik een presentatie aan de mensen die bepalen waar sprints naartoe gaan. We nodigden de mensen uit die al klaagden dat het product er niet als één geheel uitzag. Zij hadden het probleem al gezien; ze hadden er alleen nog geen naam voor.

Niemand financiert een designsystem als idee. Ze financieren het zodra ze de dertien knoppen hebben gezien.

03

Het team samenstellen uit alle teams

Een designer en een front-end developer uit elk productteam.

Met iemand uit elk team heeft de bibliotheek een stem in elke ruimte waar hij gebruikt gaat worden. Op de lanceerdag is de adoptie al gebeurd. Dat is het verschil tussen een bibliotheek die het bedrijf gebruikt en een die alleen de makers gebruiken.

Vier productteams, en de zes mensen die hun sterke punten bundelen: vier front-end developers en twee UX-designers.

04

Tools kiezen

Op het gebied van design kwam het neer op twee keuzes: waarin ontworpen werd, en waar het gepubliceerd werd. Bij Maersk was InVision in 2019 al gelicentieerd en veelgebruikt. Bij Findhotel was dat Zeplin. Beide bedrijven gebruikten Sketch. In elk geval was het antwoord de tool die al in gebruik was.

Op het gebied van development was er een nieuwe eis, in plaats van een overgeërfde: de belangrijkste overweging was om het publiceren en debuggen van een component zo automatisch mogelijk te maken.

05

Componenten maken, en afspreken wat een component is

Verdeeld onder de designers, één component per keer, en de eenheid van werk is het component in al zijn staten.

Twee designers die het werk verdelen, maken twee helften die niet passen, tenzij iemand opschrijft wat "af" betekent. Dus schreef ik negen acceptatiecriteria waar elke component aan moest voldoen.

  1. Flexibel bij resizing met autolayout
  2. Gebruikmakend van de officiële lijst met benoemde tekststijlen
  3. Gebruikmakend van de officiële lijst met benoemde kleuren
  4. Precies passend binnen het raster: één eenheid is 8px, en die kan zo nodig gehalveerd worden tot 4px
  5. Een mobiele en een desktopversie hebben, waar dat van toepassing is
  6. Geeft zo min mogelijk bewerkrechten vrij en blijft toch bruikbaar
  7. Correct benoemd, inclusief elke sublaag
  8. Getest op een canvas op schalen en op rechten
  9. Gepubliceerd op het officiële platform

Drie ervan kun je beter zien dan lezen, want elk is een regel over een vorm.

Vormregels

PlaceholderPlaceholder1u = 8px
Placeholder
2u
2u
Placeholder3u
2u
Placeholder
Placeholder
1.5u1u1u
Eén eenheid is 8px, en elke rand van de component valt op een heel aantal daarvan.
PlaceholderUser inputUser inputUser inputUser input
Zes statussen, niet één: normaal, gefocust, ingevuld, uitgeschakeld, fout en opgelost. Alle statussen van één component.
Placeholder
Placeholder
Placeholder
Welke delen meerekken en welke delen vasthouden, één keer bepaald in plaats van per artboard.
06

Publiceren, waar de discussie wordt beslecht

Bij mijn eerdere pogingen ging deze stap mis, en op dat moment leek het geen mislukking. Ik publiceerde de bibliotheek voor designers. Designers gebruikten hem, en de producten groeiden toch uit elkaar: developers die een ontwerp nabouwen vanaf een plaatje, veroorzaken dezelfde afwijkingen, één overdracht later.

Ontwerp wordt pas uitgebracht als het code is. Dus publiceerde ik deze keer voor de developers. Ik koppelde elke component tussen ontwerp en code, elk met een eigen URL in een indexbestand dat de front-end kon lezen.

Hieronder staat één component, de sterrenbeoordeling, op de drie plekken waar hij bestaat. Het is hetzelfde object, met variaties.

Wat er is opgeleverd

Pagina's die uit het design system kwamen

Deze pagina's zijn volledig samengesteld uit onderdelen die zijn gemaakt in de bijbehorende design systemen.

Findhotel, 2020

De hele funnel, op desktop en mobiel. De mobiele schermen zijn exports van de volledige pagina.

Verdieping

Floorplanner, 2018

Floorplanner, 2018

Een tekentool in plaats van een funnel. De twee marketingpagina's aan het eind zijn de interessante, want een marketingpagina die is samengesteld uit de componenten van het product zelf is een voorbeeld waarin de gids verder reikte dan het kernproduct.

Verdieping

Maersk, 2019

Maersk, 2019

Twill, het platform van Maersk voor de kleine en middelgrote exporteurs en importeurs die LCL-vracht (less than container load) boeken: zendingen die te klein zijn om een container te vullen en de ruimte en de kosten delen met de lading van anderen. De schermen hieronder volgen één boeking, van de zoekopdracht voor de bestemming tot het bevestigingsscherm.

Verdieping

Zimmer Biomet, 2021

Zimmer Biomet, 2021

Een chirurgische planner, in achttien maanden gebouwd. De meeste vensters in dit product zijn één component met andere inhoud erin. Verander de component één keer en elk venster verandert mee.

Verdieping

TrackBee, 2025

Vijf stromen getoond op drie breedtes elk: inloggen, een account aanmaken, advertentieplatforms koppelen, een abonnement kiezen, en terugkomen na een verlopen abonnement.

Conclusie

Een levend designsysteem is een systeem dat gecodeerd is

In elk product gebruikt

Toen ik vertrok was het een levende library, geïmporteerd door elk product in de portfolio in plaats van eraan gerefereerd.

Elke component toegankelijk gemaakt

Door elke component op het niveau van de W3C-richtlijnen voor toegankelijkheid te brengen, werd elk product in één keer beter.

Lessen

Een silo aan beide kanten richt dezelfde schade aan
Ook als de designers het perfect eens zijn, veroorzaken developers die het systeem nabouwen vanaf een plaatje of een gids dezelfde afwijkingen, één stap later.
Eén bron van waarheid, geen drift meer
Het principe dat voor mij het meest heeft opgeleverd, en het makkelijkst per ongeluk te breken. Elke andere plek waar een component wordt beschreven, is een plek waar hij gaat afwijken.
Maak verbeteren goedkoper dan opnieuw beginnen
Designers en developers blijven altijd produceren. Maak het verbeteren van een bestaande component de makkelijkste weg, zodat het systeem beter wordt in plaats van steeds opnieuw te beginnen.

Wat er sindsdien veranderde

Sindsdien is Figma de standaardtool voor ontwerp geworden, en Storybook heeft zijn plek behouden. De grotere verandering zit onder de tools: een designer die met agentic AI zoals Claude Code werkt, kan een component zelf schrijven en committen, in plaats van te wachten tot een developer hem bouwt.

2019 2020
Figma Het online alternatief, en nog altijd echt de uitdager, niet de standaard.
Storybook Het andere uiteinde van dezelfde plank. Een component die hier bestaat, bestaat in het product.
Zeplin De bron van waarheid waar beide kanten naar keken. Niet meer in gebruik
Sketch Waar de componenten werden getekend, en de licentie waar beide bedrijven al voor betaalden. Niet meer in gebruik
Chromatic Wat een pull request iets maakte dat een designer kon beoordelen, door een diff in een plaatje te veranderen. Niet meer in gebruik
2026
Figma Bleef precies waar het was, alleen is het niet meer de uitdager. Het is gewoon het platform waarin mensen ontwerpen.
Storybook Nog altijd het andere eind van dezelfde plank, om precies dezelfde reden als altijd.
Claude Code De echte verandering. Een designer kan hier een component direct schrijven en committen, waardoor de overdracht hierboven soms gewoon één persoon, één bestand is.