Ga naar hoofdinhoud

Community

In het kort

Een component met Community status bestaat in de community, op één of meer plekken, en voldoet aan de NL Design System architectuur. Het is klaar voor hergebruik door andere organisaties.

Doelen van Community status

  • Teams kunnen zelfstandig aan de slag zonder te hoeven wachten op het kernteam
  • Teams kunnen met vertrouwen componenten van elkaar gebruiken
  • Concurrerende versies zijn toegestaan - meerdere organisaties kunnen hun eigen versie hebben
  • Validatie dat het component bruikbaar is voor meerdere organisaties en producten
  • Teams kunnen op elkaars component doorontwikkelen zodat de overlap duidelijk wordt voor doorontwikkeling naar Candidate
  • Innovatie mogelijk op bestaande Candidate of Hall of Fame componenten door Community uitbreidingen

Wat betekent Community?

Dit component bestaat al in code bij één of meer organisaties en is gebouwd volgens de NL Design System aanpak. Het heeft een organisatie-prefix (zoals utrecht-button of denhaag-card) en gebruikt design tokens voor styling.

Community componenten zijn klaar voor gebruik. Ze zijn niet experimenteel - organisaties gebruiken ze al in productie.

Tip: Houd de organisatie prefix, ook als andere organisaties het component hergebruiken. Dit maakt duidelijk wie het onderhoudt en voorkomt verwarring over de herkomst.

Wat heb je nodig voor Community?

👉 Voor organisaties: Community stappenplan voor organisaties

👉 Voor het kernteam: Community stappenplan voor kernteam

1. Component voldoet aan NL Design System architectuur

  • ✅ Beschikbaar in CSS
  • ✅ Publiek beschikbaar in Storybook
  • ✅ Implementatie voldoet aan naam en doel uit de GitHub Discussion
  • ✅ Minimaal kleur en typografie beslissingen met design tokens geïmplementeerd
  • ✅ API's zoals design tokens hebben een prefix van de verantwoordelijke organisatie
  • ✅ Gebruikte design tokens voldoen aan naamgeving conventie
  • ✅ EUPL-1.2 licentie toegepast
  • ✅ Documentatie heeft de Creative Commons 0 licentie (CC0)

2. Kernteam maakt component beschikbaar voor hergebruik

  • ✅ Beschikbaar in de Storybook met alle NL Design System thema's
  • ✅ Visuele regressietests zijn beschikbaar in de Thema Storybook
  • ✅ Beschikbaar in de NL Design System Figma bibliotheek
  • ✅ Beschikbaar in de NL Design System Component assessment (Figma)

3. Kernteam zet component op Community

  • ✅ Status bijgewerkt naar Community
  • ✅ Informatie van de component bijgewerkt op nldesignsystem.nl
  • ✅ Gebruik van component uit de community gepromoot

Community componenten bekijken

Bekijk alle Community componenten:

Meerdere Community versies

Er kunnen meerdere Community implementaties zijn van hetzelfde component. Dat is prima! Elke organisatie kan kiezen welke versie het beste past bij hun behoeften. Door verschillende versies naast elkaar te hebben ontdekken we wat goed werkt.

Vragen?

Heb je een vraag over Community componenten?