Design system
ANWB-stylingmodule
Achttien apps met één ANWB-look, klaar voor de Mendix van straks.
- Rol
- ontwerp, herbouw en migratie
- Periode
- opgeleverd oktober 2025; tweede fase (AI-consolidatie) oktober 2026
- Opdrachtgever
- ANWB, Mendix-team
- Type
- design system / company-module
- Kerntechnologie
- SCSS, Mendix 10.24 (React-client), Atlas, Claude Code
Over het project
De Mendix-apps van de ANWB deelden een stylingmodule uit de tijd van Mendix 9. Die werkt op Dojo, de oude client (het deel van Mendix dat de pagina's in de browser opbouwt), maar Dojo verdwijnt uit Mendix. Elke app moet dus over naar de nieuwe React-client, en precies daar gaat de oude styling stuk. Daarom heb ik de stylingmodule van de grond af opnieuw gebouwd en in oktober 2025 opgeleverd. De nieuwe module vervangt de oude, en elke app haalt hem binnen via de interne marketplace.
De uitdaging
Elk van de achttien apps had zijn eigen geschiedenis. Samen ging het om ruim 20.000 stylingelementen, en daarvan was een deel dubbel, verouderd of bij eerdere migraties kapotgegaan. De nieuwe module moest er vertrouwd ANWB uit blijven zien zonder die fouten over te nemen. Daarnaast had elke app een duidelijke route nodig om over te stappen.
Wat ik heb gebouwd
- Een inventaris en consolidatie van elke stylingregel in het landschap. Dat leverde 1.270 mapping-regels op: een deel gaat naar de centrale module, een deel blijft lokaal in de app en de rest vervalt.
- 46 SCSS-partials, losse SCSS-bestanden per onderdeel, in een vaste indeling: base, elements, inputs, widgets, layout en page structure. De tokens voor kleur, ruimte en typografie volgen het Nomad-design system van de ANWB.
- Een analyse van 24 migratieproblemen. Daarvan heb ik er 15 centraal in de module opgelost, waaronder de overstap naar de nieuwe datagrids en het opruimen van Dojo-afhankelijkheden.
- Een migratiestappenplan per app, met omzetscripts erbij. In de proefapps bleef na het draaien van het script geen enkele verwijzing naar de oude module over.
Belangrijkste functionaliteit
Toekomstvast.
Er zitten geen Dojo-selectors in, ook niet als terugvaloptie, en geen selectors op interne Mendix-namen.
Atlas blijft onaangeroerd.
Atlas is het standaardthema van Mendix. Aanpassingen lopen via tokens en eigen selectors, zodat een Mendix-update de styling niet stukmaakt.
Showcase-module.
Pagina-templates en bouwblokken op een rij, zodat developers zien wat er beschikbaar is.
Hoe ik bouw
Een jaar na de oplevering, in oktober 2026, volgde de tweede fase: de consolidatie over alle achttien apps. Die heb ik als een gefaseerde AI-pijplijn in Claude Code laten draaien. Elke app kreeg een eigen geautomatiseerde run. Het vaste werk deden scripts, en voor het schrijven en het controleren had ik aparte subagents. De regels bepaalde ik zelf (wat centraal wordt, wat lokaal blijft en wat vervalt), en de uitkomst heb ik ook zelf beoordeeld. Het telwerk over twintigduizend elementen liet ik aan de AI over.
Kerncijfers
18
apps in scope
±21.000
stylingelementen geïnventariseerd
1.270
mapping-regels
46
SCSS-partials
15 / 24
migratieproblemen centraal opgelost
Gebruikte tools
- Styling
- SCSSMendix Atlasdesign tokens
- Mendix
- Mendix 10.24React-clientinterne marketplace
- AI
- Claude Code (headless runs, subagents)Python-scripts
Wat ik heb geleerd
- 01
Een design system op schaal opzetten:: van twintig losse stijlen naar één bron.
- 02
SCSS-architectuur: met tokens, partials en een strikte regel voor overrides.
- 03
Migreren zonder big bang:: elke app een eigen route geven, en centraal oplossen wat centraal kan.
- 04
AI-pijplijnen voor bulkwerk:: ik bepaal de regels, en de AI voert ze consequent uit.