Bijwerken en versies

Deze pagina legt uit hoe je een component na publicatie aanpast, hoe je een nieuwe versie uitbrengt en wanneer het versienummer verplicht omhoog moet.

Twee updatepaden

Pad	Geschikt voor	Wat kun je wijzigen
Updatepagina (Web)	Reguliere iteratie na de eerste publicatie	Code, previewconfiguratie, omschrijving, tags
comphub upload	Alleen code wijzigen en de pagina overslaan	Alleen code publiceren, metadata blijft onaangeroerd

De eerste publicatie loopt nog steeds via de uploadpagina, omdat __id__ in die stap wordt geschreven.

De updatepagina gebruiken

1. Huidige versie downloaden: zoek het component in "Mijn componenten", klik op "Bijwerken" en download eerst de online versie als basis.
2. Lokaal aanpassen: wijzig de code en werk de documentatie bij in je project.
3. Lokaal verifiëren: bekijk het met de lokale service en controleer dat bestaande functionaliteit niet is teruggevallen.
4. Update indienen: ga terug naar de updatepagina, selecteer de gewijzigde map, hoog het versienummer op, pas indien nodig preview en omschrijving aan en klik op "Bijwerken".

Wijzig je alleen de omschrijving, tags of previewconfiguratie, dan hoef je het versienummer niet op te hogen.

Bijwerken met de CLI

comphub login                                  # één keer per machine
cd src/components/MyComponent
comphub upload -m "tooltip-positionering gecorrigeerd"

Je kunt de map ook expliciet opgeven:

comphub upload src/components/MyComponent -m "tooltip-positionering gecorrigeerd"

Verschillen met de updatepagina:

• Versieverhoging is verplicht: als de version in de lokale comp.json niet groter is dan de online versie, weigert de CLI direct.
• Omschrijving, tags en previewconfiguratie blijven onaangeroerd: die wijzig je alleen via de updatepagina.

Vóór het indienen kun je een droge run doen:

comphub upload -m "tooltip-positionering gecorrigeerd" --dry-run

--dry-run print het projectpad, de component-ID, de online versie en de versie die zou worden gepubliceerd, en stopt dan zonder iets in te dienen.

Semantische versies

major.minor.patch

Type	Wijziging	Voorbeeld
Patch	Bugfix, backwards compatible	1.0.0 → 1.0.1
Minor	Nieuwe functionaliteit, backwards compatible	1.0.0 → 1.1.0
Major	Breaking change	1.0.0 → 2.0.0

Versie verplicht omhoog: als je componentcode, de props-interface of de gedragslogica wijzigt.

Niet nodig: als je alleen de omschrijving, tags of previewconfiguratie wijzigt.

Het versienummer op twee manieren wijzigen

Updatepagina: wijzig het versienummer direct in het invoerveld van het configuratiegebied; het platform schrijft het synchroon naar comp.json.

Lokaal handmatig wijzigen:

{
  "name": "MyComponent",
  "version": "1.1.0"
}

Vergeet niet op te slaan; de CLI leest precies dit bestand.

Meerdere versies naast elkaar

Het platform bewaart historische versies. Gebruikers kunnen:

• op de previewpagina tussen versies schakelen om verschillen te bekijken;
• elke historische versie downloaden;
• in hun eigen project de gebruikte versie vastzetten.

Een al gedownloade oude versie verandert niet automatisch wanneer een nieuwe versie verschijnt.

Wijzigingslogboek

Onderhoud bij voorkeur in README.md:

## Wijzigingslogboek

### 1.1.0 (2026-10-26)

- Nieuw: ondersteuning voor een eigen themakleur
- Optimalisatie: renderprestaties bij grote datavolumes

### 1.0.1 (2026-10-20)

- Opgelost: tooltip werd in sommige gevallen niet getoond

Voor gebruikers is de README een betere basis om te bepalen of ze moeten upgraden dan het versienummer.

Als het resultaat van de inzending onzeker is

Meldt de CLI Submit result cannot be confirmed of treedt er een time-out op, dan heeft de server de update mogelijk al weggeschreven. Probeer niet direct opnieuw, maar controleer eerst de nieuwste versie op de detailpagina van het component:

• Versie is bijgewerkt: niet opnieuw proberen.
• Versie is niet veranderd: voer de upload nog eens uit.

Volgende stappen

• Volledige uitleg over de commandoregel: De CLI gebruiken
• Fouten tijdens het bijwerken: FAQ en terminologie