Naar de inhoud
Vrules Designsystem / 2.4Open de voorbeelden

Vrules voor
applicaties.

Bekijk kleur en compositie in gebruik ↗

Ontwerpregels voor de zes onderzochte applicaties, met voorbeelden die je kunt uitproberen en aanpassen voor je eigen project.

Versie 2.4.0 · 12 oktober 2026 · HTML, CSS, JavaScript, tokens en ontwerpregels

Wat de voorbeelden laten zien

Je kunt in de voorbeelden onder meer locaties vergelijken en een afspraak afronden met verplicht bewijs. De ontwerpregels beschrijven ook wat er gebeurt als opslaan mislukt of gegevens ontbreken.

De broncode en publieke schermen zijn onderzocht. De ingelogde productieprocessen zijn niet doorlopen. De voorbeelden zijn fictief en veranderen niets in de zes applicaties.

Kleur en compositie

Het volledige Vrules-palet hoort ook in digitale producten. Een product is niet af zodra het een donkere bovenbalk, oranje knop en verder grijze panelen heeft. Gebruik de kleurvlakken en typografische hiërarchie uit papers en presentaties om inhoud te ordenen. Compacte afstanden uit density.md blijven gelden.

Wat we overnemen uit andere media

BronVertaling naar web en appBegrenzing
Donkere paperopeningCompact contrasterend samenvattingsvlak of redactionele openingGeen grote hero boven dagelijkse bediening
Getinte tabellen en vergelijkingsdia'sEén kleurfamilie voor een analysegebied, met zachte ondergrond en donkere koppenTabelbody en invoervelden blijven goed leesbaar
Infographic met inhoudelijke kleurcoderingHerkenbare kleuren voor benoemde categorieën, fasen of reeksenAltijd labels; categorie is geen status
Presentatiedia met hoofdgetalHoofdgetal 32–44 px, eenheid en toelichting erbij; ondersteunende cijfers kleinerNiet ieder cijfer even groot, geen decoratieve KPI-tegels
Redactionele pagina met beeld en zijstukBreder hoofdonderdeel met smalle contextkolom, of beeld met compacte lijstDOM-volgorde blijft logisch; mobiel onder elkaar

Kleurrollen

Gebruik expression.families in tokens.json. Deze bevatten aparte licht- en donkerparen. expression.css levert dezelfde waarden voor .vr-app en .vr-web.

FamilieGebruik in inhoudVoorbeeld
PetrolProces, werkcontext en begeleidingWerksamenvatting, route of uitleg bij een opdracht
BlauwAnalyse, vergelijking en gegevensVergelijkingsgebied, tabelkop of hoofdgetal
AubergineLeren, reflectie en verdiepingOefensituatie, lesintro of redactioneel kader
OranjeMerk, primaire actie en incidenteel warm inhoudsvlakBesluit dat aandacht verdient; knop behoudt donkere tekst

Kies per scherm een leidende familie en zo nodig een tweede voor een duidelijk ander inhoudstype. Dit is geen verplicht aantal kleuren: een eenvoudig formulier mag neutraal blijven. Een inhoudsvlak mag volledig getint of donker zijn. Gebruik geen losse gekleurde zijlijnen, accentstrepen of inset-schaduwen. Navigatieselectie blijft neutraal; kleur in de inhoud hoeft niet in iedere knop terug te komen.

Kleurfamilies zijn onafhankelijk van status. Een petrol lesblok is niet automatisch afgerond; een aubergine project is geen waarschuwing. Voor fouten, succes en geselecteerde elementen blijven de bestaande semantische tokens en tekstlabels verplicht. Binnen een gekleurd vlak blijven invoervelden, knoppen en statuslabels hun eigen leesbare kleuren houden. Geen kleuren stapelen via overerving.

CSS aansluiten

Laad eerst de bestaande fonts en application-tokens.css, daarna de basiscomponenten en als laatste expression.css. Gebruik .vr-app op een applicatie of .vr-web op de container van een website. De website behoudt zijn eigen basistypografie en componenten; expression.css voegt alleen de beschreven bouwstenen toe. Kies licht, donker of automatisch op dezelfde container. Gebruik data-palette op een inhoudsblok binnen die container. Geneste kleurvlakken worden niet aanbevolen.

Herbruikbare vormen

Gebruik een statuscomponent altijd met zijn statusnaam en eigen achtergrond. Gebruik voor links binnen een sterk vlak onderstreepte tekst in de lokale tekstkleur; actieknoppen behouden de normale knoptokens. Verbind kleur met de inhoud, niet met de toevallige positie van een kaart.

Toepassen per product

Een tracker kan een petrol samenvatting combineren met een neutrale bewerkbare tabel. Een dashboard gebruikt blauw voor analyse, een groter hoofdgetal en compacte bronvermelding. Een leeromgeving kan aubergine gebruiken rond de oefensituatie en de feitelijke bediening neutraal houden. Een reiswebsite gebruikt echte fotografie en petrol voor routecontext. Een redactionele website wisselt een donkere opening af met leesbare witte inhoud en een getint zijstuk. Pas een bestaande projectidentiteit alleen aan wanneer de opdracht dat toestaat.

Controle

Beoordeel het hele scherm: helpt de kleur om inhoud te onderscheiden, is er een duidelijk zwaartepunt en blijft de hoofdtaak snel bereikbaar? Geen decoratieve opvulling, verplichte drietallen, extra kaartlagen of meer witruimte om het rijker te laten lijken. Controleer alle tekst-/achtergrondparen in beide thema's (gewone tekst minimaal 4,5:1), toetsenbordfocus op elk vlak, mobiele volgorde en overloop. Controleer ook dat fout- en statuskleuren niet door een inhoudsthema worden overschreven.

Download deze referentie

Ontwerpregels

Vrules 2.3 bevat regels voor werkschermen, zoals een afsprakenoverzicht, een locatievergelijking en een formulier. Het bestaande logo, de kleuren en lettertypen blijven in gebruik.

Bepaal wat de gebruiker moet doen

Leg vóór vormgeving vast: wie gebruikt dit, welke beslissing of handeling staat centraal, welke informatie is nodig, wat kan misgaan, en wanneer is het werk werkelijk opgeslagen? Gebruik bestaande routes, domeinregels en componentbibliotheken. Een nieuwe stijl is geen reden om een werkende backend te vervangen.

Kies het toepassingsprofiel in application-profiles.md. Volg application-components.md voor gedrag, application-quality.md voor acceptatie en migration.md voor invoering. De HTML/CSS/JS in werkplaats/ is een bewerkbare referentie met fictieve gegevens. Het is geen productiebackend of complete componentlibrary voor ieder framework.

Lees ook expression.md voor rijke kleurtoepassing, typografische rollen en compositie. De compacte opmaak blijft de basis.

Identiteit en compositie

Selectie en bovenkopjes

Geen decoratieve gekleurde zijranden, accentstrepen of inset-schaduwen aan kaarten, invoerblokken, callouts, tabs of actieve navigatie, ongeacht de kleur. Gebruik rustige vlakvulling, tekstgewicht en neutrale scheidingslijnen. Behoud zichtbare toetsenbordfocus, veldranden bij validatiefouten en betekenisvolle statuslabels.

Bovenkopjes zijn alleen toegestaan wanneer ze informatie toevoegen die nodig is om de inhoud te begrijpen, zoals een organisatie, project, land of periode. Schrap labels als “WERKRUIMTE” en “AFSPRAKEN & OPVOLGING” boven een duidelijk afsprakenoverzicht. Herhaal niet de geselecteerde navigatie of paginatitel als bovenkop. Geen automatische hoofdletters, extra letterspatiëring of standaard eyebrow bij ieder blok.

Een geselecteerde navigatieknop krijgt een neutraal achtergrondvlak en zwaardere tekst. De lijst-/bordkeuze gebruikt hetzelfde principe. Een formulier heeft gewone veldranden; er loopt geen oranje lijn langs het hele invoerblok.

Controleer het scherm zonder bovenkopjes: blijft de betekenis gelijk, dan kunnen ze weg. Een projectnaam in een detailvenster en het land bij een locatie blijven staan als ze helpen het object te herkennen.

Typografie en dichtheid

RolMaat / regelhoogteGebruik
PaginakopBarlow 32 px / 1,15Eén h1 per werkruimte; mobiel 28 px
SectiekopBarlow 24 px / 1,25Taakgebieden en detailpanelen
Interface en formulierSource Sans 3 16 px / 1,5Standaard, ook op mobiel
Tabel en metadataSource Sans 3 14 px / 1,5Labels blijven leesbaar; geen 10 px statuskoppen
Lange uitlegSource Sans 3 18 px / 1,65Maximaal 68ch, buiten compacte tabelcellen
CijfersSource Sans 3, tabular-numsDecimalen uitlijnen, eenheid zichtbaar

Compacte rijen van minimaal 44 px zijn standaard op desktop met precieze aanwijzer. Comfortabele rijen van 56 px zijn optioneel en blijven de basis op touch. Rijhoogte groeit mee met tekst en bediening; verklein geen letters. Panelen hebben 16 px padding, tussen blokken 16 px en tussen gerelateerde velden 8–12 px. Vermijd dubbele witruimte door gestapelde padding en margins. Touchdoelen standaard 44 × 44 px. Dit is onze ontwerpregel; WCAG 2.2 AA kent een minimum van 24 × 24 CSS-pixels met uitzonderingen.

Raster, lagen en responsiviteit

Appwerkruimte maximaal 1440 px. Sidebar 240 px, detailpaneel maximaal 608 px. Buitenmarges 24 px, mobiel 16 px; gebruik de bestaande 4/8/12/16/24/32/48/64/96-schaal. Besturing 3 px radius, informatiepanelen recht. Schaduw alleen bij echte lagen zoals een modaal paneel.

Onder 960 px wordt de navigatie een zichtbare horizontale of inklapbare lijst; ze blijft bereikbaar zonder hover. Onder 640 px komen filters onder elkaar en detailpanelen over de volle breedte. Een tabel krijgt een benoemde horizontaal scrollbare regio; verberg nooit stilzwijgend kritieke kolommen. Een mobiel bord wordt een verticale lijst van fasen. De visuele volgorde volgt de DOM. Test lange Nederlandse labels en 200% tekst.

Kleuren voor acties en statussen

../tokens.json is de bron. application-tokens.css bevat de gegenereerde, tot .vr-app beperkte waarden. Merk-oranje is voor merk en primaire acties. Navigatieselectie gebruikt een neutraal vlak; risico krijgt een benoemde status. Gebruik op #FF873E donkere tekst (#0C1013): het contrast is 7,99:1. Witte tekst haalt 2,39:1 en voldoet hier niet aan de WCAG-contrastnorm, ook niet voor grote tekst. Success/petrol, warning/oker, error/rood en info/blauw hebben steeds een tekstlabel en zo nodig een symbool. De exacte domeinstatus blijft leidend: ‘Geboekt’ is iets anders dan ‘Afgerond’ of ‘Geslaagd’.

Licht/donker/automatisch zijn expliciete keuzes. Gebruik uitsluitend semantische variabelen voor ondergrond, tekst, rand, bediening, selectie, focus en status. Scheidingsranden mogen subtiel zijn; de omtrek van een invoerveld moet voldoende herkenbaar blijven. Selectie gebruikt rustige vlakvulling en tekstgewicht, met de juiste geselecteerde toestand voor hulptechnologie. Gebruik geen accentlijn of inset-schaduw als selectiemarkering. Focus heeft een 3 px contrasterende ring met 3 px afstand.

Betrouwbare gegevens

Iedere kernwaarde heeft definitie, eenheid, periode en zo nodig bron en actualiteit. Ontbrekend is ‘Niet beschikbaar’, nul is 0, een raming heet ‘Raming’. Vergelijk alleen vergelijkbare periodes en populaties. Zelfinschatting en kennistoets zijn verschillende meetinstrumenten; hun verschil is geen bewezen leerwinst. Toon certificaten uitsluitend volgens de werkelijke uitgiftevoorwaarden.

Tijdstippen krijgen de relevante tijdzone; relatieve tijd mag naast een exact tijdstip. Deadlines, rechten en geldige statusovergangen worden op de server afgedwongen. UI-uitschakeling is slechts toelichting. Privégegevens worden niet publiek gemaakt door een layoutwijziging.

Rustige beweging

Overgangen 120–180 ms en alleen waar ze toestand verklaren. Respecteer reduced-motion. Geen verplichte confetti, tellers die eerst vanaf nul animeren of geluid bij iedere stap. Geluid vraagt een bewuste keuze. Een tijdslimiet vraagt een functionele reden en waar mogelijk pauze of verlenging.

Grenzen van deze release

De startset demonstreert patronen voor zes producten. Voor productie blijven integratie met opslag, rechten, validatie, synchronisatie, echte brongegevens en projectspecifieke tests nodig. De zes oorspronkelijke applicaties zijn door deze release niet gewijzigd. De bestaande Word- en LinkedIn-sjablonen blijven geldig; hun mediumregels veranderen niet.

Download deze referentie

Wat de zes projecten nodig hebben

Onderzoek: 8 oktober 2026. Broncode en publieke desktop-/mobielpagina’s bekeken. Geen ingelogde productiehandelingen uitgevoerd. De commitankers staan in research.json. Dit is een ontwerp- en implementatieanalyse, geen volledige beveiligings-, toegankelijkheids- of gebruikerstest.

Commitment Tracker — werk en verantwoording

Bron: Vrulesnl/commitment-tracker, public/index.html, public/style.css, public/app.js, docs/TECHNISCH-PLAN.md. Publiek: loginpagina. De bestaande sidebar, overzichtscijfers, filters, tabel/bord en detaildialoog vormen een bruikbare functionele basis. Veel compacte metadata en tabeltekst vragen om een consequente 14/16 px hiërarchie.

Toevoegen: comfortabele en compacte dichtheid, eenduidige afspraakkaart, detail met afspraak/bron/bewijs/historie, aandacht met concrete reden, concept- en conflictpatroon. Maak persoon, project, richting en deadline scanbaar. Ontvangen en uitgaande afspraken moeten visueel onderscheidbaar zijn zonder afhankelijkheid van kleur.

Bewaren: verplichte onderdelen kunnen afronden blokkeren; bewijs bij afronden; versieconflicten niet overschrijven; spraak/AI-kandidaten eerst laten beoordelen. Een decoratief groen vinkje mag deze regels niet passeren.

Pilot: overzicht met filter → detail bewerken → bewijs toevoegen → afronden. Acceptatie: toetsenbord door hele taak, fout behoudt invoer, bordovergang kent dezelfde regels als formulier, mobiel dezelfde functies.

Bergbasis / Reisplanning — zoeken, kiezen en plannen

Bron: Vrulesnl/bergbasis, AGENTS.md, app/globals.css, componenten voor locatiezoeker, bronnen/provenance, status, mini-map, formulierbescherming en mobiele navigatie. Publiek: vakantie.vrules.nl. Er zijn al patronen voor bronherkomst, echte coördinaten en bescherming van invoer; hergebruik die.

Toevoegen: kaart/lijst-pariteit, vast filtergebied, locatiekaart met feitelijke kenmerken en echte fotoherkomst, vergelijking van 2–4 kandidaten, reis-/stopdetail, leesbare bronnen en onzekerheid. Maak ‘onderzoeken’, ‘shortlist’, ‘geselecteerd’, ‘geboekt’ en ‘bezocht’ afzonderlijke begrippen.

Bewaren: maximaal één geselecteerde/geboekte kandidaat per stop; bezocht is historie; publieke seizoensinformatie versus privé exacte reisdata; onbekende coördinaten geven geen pin. Vergelijkselectie boekt niets en verandert geen kandidaatstatus.

Pilot: locaties filteren → 2–4 vergelijken → kandidaat bij stop bekijken. Acceptatie: geen dataverlies bij navigatie, onvolledige brongegevens zichtbaar, op telefoon vergelijken zonder kritieke criteria kwijt te raken.

DigitalNext — gestructureerd leren

Bron: Vrulesnl/aigeletterdheid, frontend/src/pages/{Dashboard,Lesson,SelfScan,Toets,Voortgang,Certificaten}.tsx, data/learning.ts. Publiek: digitalnext.vrules.nl. De dashboardroute heeft thema’s, modules, zelfscans, toetsen en certificaten. Les- en toetscomponenten hebben al feedback en voortgang.

Toevoegen: vaste lesbreedte, rustige stapnavigatie, hervatstatus, vraag/antwoord/feedbackcomponent, toegankelijke voortgang, certificaatvoorwaarden en tekstalternatief bij grafieken. Scheid zelfinschatting van aangetoonde toetskennis.

Concrete aandacht: Toets.tsx berekent een verschil tussen toets en zelfscan. Noem zo’n verschil niet automatisch leerwinst: de meetmethoden verschillen. Controleer bij migratie ook welke voortgang lokaal of accountgebonden wordt bewaard en zeg dat expliciet tegen gebruikers.

Bewaren: inhoud en echte bronverwijzingen, onderscheid oefening/toets/zelfscan, werkelijke slaaggrens en certificaatvoorwaarden. Geen certificaat uitgeven omdat een demonstratievraag goed is.

Pilot: hervatten → les → oefenvraag → feedback → voortgang. Acceptatie: vorige stap bewaart antwoord, voortgang noemt de juiste scope, sound/reduced-motion gerespecteerd, grafiek ook tekstueel leesbaar.

Scoredock — bestuurlijke informatie en beheer

Bron: Vrulesnl/AI-OKR, components/AppShell.tsx, Layout.tsx, UIStatePanel.tsx, LicensesOverviewSection.tsx, project-/contract-/OKRcomponenten en permissieservices. Publiek: scoredock.app. De vier modules delen organisatiecontext, rechten, dashboards, signalen en bewerking. Dat vraagt een samenhangende app-shell en vergelijkbare detailstructuren.

Toevoegen: contextwissel organisatie/module/periode; tabel- en rapportageregels; KPI’s met bron, actualiteit, periode en eenheid; objecthiërarchie en breadcrumbs; rollen/alleen-lezen; importvoorvertoning en foutregels; consistente signalen.

Concrete aandacht: UIStatePanel.tsx bevat 10 px statuskoppen. LicensesOverviewSection.tsx gebruikt bij sommige formatters Number(value || 0); bij migratie per gegevensveld controleren of afwezig werkelijk nul mag betekenen. Dit is een codebevinding, geen bewering dat ieder live scherm verkeerde cijfers toont.

Bewaren: organisatie- en objectrechten, thema/doel/subdoel/resultaat-hiërarchie, periodebetekenis, contracttermijnen, licentie-eenheden. Houd productie- en demogegevens gescheiden. Respecteer de bestaande staging→main releaseprocedure bij latere implementatie.

Pilot: periode kiezen → signalen filteren → detail met bron bekijken → bewerken als rol dat toestaat. Acceptatie: nul en ontbrekend verschillen, tabellen sorteren getallen correct, rechten servergetest, opgeslagen wijzigingen krijgen bevestiging.

TalentTakeOver — workshop en ontdekking

Bron: Vrulesnl/talent-takeover, gedeelde tto-ui.css, quiz-, groeps-, workshop- en docentpagina’s. Publiek: talent.vrules.nl. Het project heeft een eigen De Borne-afzender, groepvarianten en een energieke vormgeving. Behoud bij een herontwerp de schoolafzender en stem tekst en bediening af op de leeftijdsgroep.

Toevoegen: workshopstappen, grote begrijpelijke antwoordkeuzes, vriendelijke foutfeedback met uitleg, duidelijke leerling-/docentcontext, rustiger bewegingsregels en instelbare tijd waar mogelijk. Pas taal en informatiedichtheid aan de groep aan, niet alleen de kleur.

Bewaren: school/projectafzender en groepsinhoud; quizspel is geen formeel certificaat. Een bestaande 45-seconden-timer vraagt een bewuste productkeuze over pauzeren/verlengen; verwijder spelregels niet stilzwijgend.

Pilot: groep/activiteit → opdracht → keuze → uitleg/herproberen. Acceptatie: toetsenbord en aanraking gelijkwaardig, feedback niet alleen kleur, geen geluid zonder keuze, geen leesbare leerlinggegevens publiek.

DeWKPool — voorspellen en volgen

Bron: Vrulesnl/dewkpool, werkelijk geserveerde api/public/, onder meer voorspellingen.html, stand.html, en bestaande claude/skills/dewkpool-design/. Publiek: dewkpool.nl. Er bestaat al een projectspecifiek designsystem: gebruik het als migratiebron. Let op de dubbele frontendstructuur; wijzigingen in de verkeerde map worden niet live.

Toevoegen: uniforme wedstrijdrij, score-invoer, deadline en vergrendeling, opslag-/offlinefeedback, ranglijst met gelijke standen, actuele versus voorlopige uitslag, consistente navigatie en subpoolcontext. Oranje voor Nederland blijft een productbetekenis, niet iedere kaart krijgt het.

Bewaren: puntentelling, tiebreaks, deadlines en slot op servertijd, privacy van voorspellingen, eigen rangmarkering. Een leeg scoreveld is niet automatisch 0–0; een opgeslagen voorspelling is niet de echte uitslag.

Pilot: wedstrijd kiezen → voorspelling bewaren → vergrendelde toestand → stand bekijken. Acceptatie: geldige 0–0, ongeldige negatieve/decimale invoer afgewezen, geen lokale kloktruc om na deadline te schrijven, herstel zonder dubbele mutatie.

Prioriteit

  1. Gedeelde basis en gedrag: app-shell, leesbaarheid, statusbetekenis, formulier/detail, fout- en conceptbehoud.
  2. Per product één verticale pilot zoals hierboven, met echte gegevens en rechten in de eigen testomgeving.
  3. Brede uitrol: overige schermen, geavanceerde imports/kaarten/bulkacties en regressietests.

Test bij iedere omzetting of gebruikers hun werk kunnen afmaken met echte gegevens. De voorbeelden in deze release zijn nog niet gekoppeld aan de opslag en toegangsrechten van de zes applicaties.

Download deze referentie

Gedrag per component

Een component is pas af wanneer inhoud, bediening, alle relevante toestanden en herstel zijn beschreven. Gebruik native HTML waar mogelijk; maak geen ARIA-grid van een gewone tabel.

ComponentAnatomie en gedragRandgevallen en acceptatie
App-shellProject/organisatie, hoofdnavigatie, actieve route, h1, taakactie. Routes zijn links; lokale weergavewissels zijn knoppen.Geen decoratieve accentlijn of inset-schaduw voor de actieve route. Gebruik neutrale vlakvulling, tekstgewicht en aria-current of aria-pressed waar van toepassing. Geen bovenkop die alleen de actieve route herhaalt. Geen dubbele actieve routes. Organisatiewissel benoemt scope en bewaakt onopgeslagen werk. Mobiel blijft dezelfde taak bereikbaar.
Zoek- en filterbalkZichtbaar label, zoekveld, relevante filters, resultaataantal, wisactie.Nul resultaten verschilt van een lege database. Filters blijven bij terugkeer behouden. Kies URL-query voor deelbare filters; geen privézoektekst in publieke URL’s.
GegevenstabelCaption, echte th/td, scope, eenheden in kop, benoemde rijacties. Sorteerknop met aria-sort op th.Null ≠ 0; geen klikbare hele rij zonder aparte link/knop. Sorteer numeriek/datumgetrouw. Paginering of virtualisatie alleen waar aantallen het vragen; aangekondigd bereik en behouden selectie.
BulkselectieCheckbox per rij en ‘selecteer deze pagina’, aantal geselecteerd, expliciete actie.Selectie buiten filter of pagina moet benoemd worden. Geen stilzwijgende selectie van alle records. Bulkmutatie kent serverrechten en gedeeltelijke fouten.
BordGelabelde fasen, aantal, compacte objectkaart, eigenaar en relevante deadline.Verplaatsen kan via toetsenbordbesturing/selectie, niet uitsluitend slepen. Server controleert overgang. Op telefoon fasen onder elkaar.
FormulierPermanent label, uitleg vóór invoer waar nodig, veldfout via aria-describedby, aria-invalid.Toon fouten na submit of zinvol veldmoment, behoud alle invoer, focus eerste fout. Gebruik foutoverzicht bij veel fouten. Opslaan = pas succes na bevestigde opslag. Voorkom dubbel verzenden.
Detailpaneel / modalTitel, sluitknop, logische volgorde, inhoud, taakacties. Native dialog met showModal in referentie.Focus naar zinvol begin, binnen modal, Escape sluit via conceptbewaking, focus terug naar opener. Achtergrond inert. Bij onopgeslagen invoer: doorgaan met bewerken of expliciet verwerpen.
Tabs / stappenTabs alleen voor panelen binnen één object, volgens APG met pijltjestoetsen. Stappen tonen huidige stap en totaal.Geen tabs gebruiken als onvolledige imitatie van routing. Vorige stap bewaart antwoorden. Verplichte invoer voorkomt onbedoeld overslaan.
Status en meldingKort label + verklaring + mogelijke vervolgactie. Inline bij het betrokken object.Kleur is aanvullend. role=status voor niet-dringende feedback, role=alert voor urgente fouten. Geen hele werkruimte als live region. Toast nooit enige plek van belangrijke foutinformatie.
VoortgangBenoemde progress/max-waarden, tekst ‘3 van 8’, volgende stap.Onderscheid gelezen, afgerond, getoetst en geslaagd. Onbekende duur geen schijnnauwkeurige percentagebalk.
Vergelijking2–4 gekozen objecten, dezelfde criteria/eenheden/bronkwaliteit, verwijder per object.Vijfde selectie geeft verklaring. Selectie verandert geen boekingsstatus. Mobiel scrollregio met blijvende attribuutnamen of gestapelde vergelijkbare blokken.
Kaart/lijstWerkelijke coördinaten, legenda, equivalent bereikbare lijst, geselecteerd object gedeeld.Geen coördinaten? Geen gefingeerde pin. Verberg adres/reisdata volgens privacyregels. Map-provider en attributie blijven zichtbaar.
Kalender / tijdlijnDatum, tijdzone, eigenaar/gebeurtenis en bron. Dag/maandnav heeft duidelijke namen.Exacte deadlines niet alleen ‘morgen’. Zomertijd/grensgevallen testen. Datumvelden mogen native zijn; bereik heeft begin/eindvalidatie.
Grafiek / KPINaam, eenheid, periode, schaal, legenda, vergelijking en datatabel.Nulbasis bij balken tenzij duidelijk gemotiveerd; ontbrekende waarden niet interpoleren zonder uitleg. Teken/patroon naast kleur. Geen ‘groei’ uit onvergelijkbare metingen.
Leerroutine / quizEén vraag of beperkte taak, permanente antwoordlabels, expliciete controle, inhoudelijke feedback.Geen schaamtecopy. Herproberen en hervatten volgens productregels. Timer waar mogelijk verstelbaar. Leraar-/leerlingrechten worden technisch geborgd.
Score-invoer / ranglijstDeelnemerslabels, niet-negatieve gehele scores, opslagstatus, deadline/slot.Invoer 0–0 is geldig; ontbrekend niet 0–0. Vergrendeling op servertijd. Gelijke punten volgens vastgelegde tie-break, nooit willekeurige rang suggereren.
Import / bronbewijsBestandsvereisten, inspectie, mapping, voorvertoning, rijgebonden fouten, bevestiging.Onbekend formaat verandert geen records. Formules/tekst blijven data; AI-extractie blijft voorstel tot review. Toon herkomst en bewerkingsgeschiedenis.

Toestanden, voor ieder asynchroon werkgebied

Referentie versus productie

De werkplaats implementeert native dialog/focus, conceptbewaking, validatie, zoeken, statusfilter, tabel/bord, sorteren, vergelijking, voortgang, quizfeedback en scorevergrendeling als lokale voorbeelden. Navigatie wisselt zes demonstraties. Herladen reset de voorbeelden. Native confirm voor verwerpen is een functionele referentie; een product mag een gelijkwaardig toegankelijk bevestigingsvenster gebruiken. Conflict en offline zijn zichtbaar gekozen simulaties; koppel in productie echte foutcodes en retry-semantiek.

Niet als complete code geleverd: backendautorisatie, datagridvirtualisatie, bulkmutaties, kaartprovider, bestandsimport, betalings- of boekingsflow. Gebruik het contract en de bestaande projectimplementatie; presenteer documentatie niet als geteste productiefunctionaliteit.

Download deze referentie

Controle voor publicatie

Voor iedere gewijzigde werkstroom

  1. Voer de hoofdtaak uit met realistische lange tekst, lege waarden, nulwaarden en foutieve invoer. Controleer opgeslagen resultaat, niet alleen de klik.
  2. Test laden, leeg, geen resultaten, fout, succes, alleen-lezen en de relevante conflict/offlinevariant. Er is altijd een concrete volgende stap; een fout wist geen invoer.
  3. Doorloop met toetsenbord: logische focusvolgorde, zichtbare focus, geen verborgen element in tabvolgorde, Escape en focusherstel bij dialogen. Native controls behouden hun normale bediening.
  4. Controleer 320, 390, 768, 1440 px, plus 200% tekstvergroting. Geen pagina-overflow, afgekapt label of verborgen primaire actie. Een tabel mag in een benoemde regio scrollen. Controleer softwaretoetsenbord en sticky elementen op een echte telefoon bij productacceptatie.
  5. Controleer licht, donker en OS-voorkeur; reduced-motion; kleurcontrast van tekst en noodzakelijke bediening. Streef naar WCAG 2.2 AA. Een paar automatische checks bewijst geen volledige conformiteit.
  6. Controleer namen/rollen/waarden met accessibility tree en bij productacceptatie een screenreader. Test ook lange vertalingen, datumnotatie, tijdzones en numerieke sortering.
  7. Controleer backendrechten, deadlines, dubbele submits, versieconflicten en herladen. Referentie-JavaScript is geen autorisatie- of opslaglaag.
  8. Leg routes, apparaten, testresultaten, beperkingen en screenshots vast. Publiceer alleen met de actuele autorisatie en het eigen releaseproces van het project.

Maatstaven

De gebruiker kan de huidige context aanwijzen, de eerstvolgende taak vinden, een status verklaren en een fout zelfstandig herstellen. Meet bij een productpilot taakvoltooiing, mislukte invoer, herstel en ervaren duidelijkheid. Leg eerst een nulmeting vast; verzin geen verbeterpercentages. Houd renderwerk licht: geen zware decoratieve video, onnodige fonts of extra framework voor een statische tabel.

Referenties

Releasecontroles voor deze startset staan in QUALITY.md. Productacceptatie in de zes apps volgt bij hun eigen migratie.

Controle op decoratie

Inspecteer navigatie, lijst-/bordkeuzes, formulieren en meldingen in de render én CSS. Geen gekleurde zijlijn, pseudo-element of inset-schaduw als accent. Controleer focus apart met Tab; de focusring moet zichtbaar blijven. Controleer foutmeldingen met ongeldige invoer; veldrand en tekst blijven herkenbaar. Lees bovenkop en titel samen: verwijder de bovenkop als deze geen extra context geeft. Hoofdletters of letterspatiëring zijn geen reden om een redundant label te behouden.

Dichtheid

Visuele rijkdom

Download deze referentie

Toepassen in een bestaande applicatie

Werk per verticale taak

  1. Lees repository-instructies, routes, bestaande tokens, componenten en releaseafspraken. Kies Vrules-identiteit of een expliciet overeengekomen projectvariant.
  2. Maak een inventaris van schermen, toestanden en domeinregels. Gebruik het profiel als start, controleer de huidige bron; het onderzoek van 8 oktober 2026 is een momentopname.
  3. Introduceer de semantische applicatietokens in een afgebakende root. Map bestaande componenten naar deze waarden. Gebruik geen globale reset die de publieke site onbedoeld wijzigt.
  4. Bouw één werkstroom van overzicht tot bevestigde handeling. Begin bij Commitment Tracker met overzicht/detail/afronden; zie de andere pilots in de profielen.
  5. Koppel echte data en backendfouten. Laat de app bestaande auth, rechten, opslag en statusovergangen gebruiken. Demo-opslag in geheugen mag nooit stilzwijgend in productie overblijven.
  6. Voer de kwaliteitsmatrix uit, laat doelgroepgebruikers de taak proberen, corrigeer en breid daarna uit. Publiceer via het projectproces en bewaar een terugvalversie.

Overdracht aan ontwikkeling

Lever broncode, tokenmapping, component-/toestandenlijst, domeinregels, screenshots, uitgevoerde checks en open punten. Benoem welke data fictief is en welke endpoints nog gekoppeld moeten worden. Behandel ontwerp en backendcontract als twee expliciete onderdelen.

De startset is gewone HTML, CSS en JavaScript, zonder installatie. In React/Next vertaal je de markup en lokale state naar bestaande componenten en hooks; behoud semantiek en toetsenbordgedrag. Hergebruik Base UI/shadcn waar al aanwezig. Voor vanilla apps kan scoped CSS rechtstreeks worden opgenomen. De referentie mag niet als losse iframe boven de echte applicatie worden geplakt.

Versiebeheer

2.3.0 is een additieve minorrelease. Merklogo en kernfonts blijven gelijk. De bestaande Office-sjablonen blijven gelden. Publiceer wijzigingen aan gedeelde tokens met impactlijst; werk CSS, skill, plugin en downloads vanuit dezelfde bron bij. Een verandering in statusbetekenis vraagt een migratienotitie, ook wanneer de kleur hetzelfde blijft.

Download deze referentie

De skill gebruiken

De applicatieregels en startset zitten ook in de vernieuwde skill. Gebruik dezelfde aanroep in een omgeving waarin de skill beschikbaar is:

sk-vrules: ontwerp deze applicatie met Vrules 2.4. Begin bij de hoofdtaak, behoud de bestaande werking en werk overzicht, detail en foutafhandeling uit. Controleer desktop, mobiel en toetsenbordbediening.

Installatie en gebruik · Onderzochte bronversies · Uitgevoerde controles