FAQ en terminologie
Starten en lokale service
De poort is bezet / een andere poort heeft geen effect
-p werkt alleen als de master nog niet draait. Voer eerst comphub kill uit en daarna comphub -p 8080.
Het commando comphub bestaat niet
Gebruik npx comp-hub, of installeer globaal en open de terminal opnieuw: npm install comp-hub@latest -g.
Bij het starten wordt gemeld dat je moet upgraden
Voer npm install comp-hub@latest -g uit en start daarna opnieuw.
De terminal blijft logs tonen
Dat zijn de servicelogs van het huidige project. Met Ctrl+C beëindig je ze en schrijf je het project uit; andere projecten blijven onaangetast.
Componentmarkt en preview
Een component staat niet in Aanbevolen/Nieuwste/Populair
De eerste drie lijsten filteren componenten met niet-overeenkomende dependencies weg. Schakel over naar "Alle" om het te bevestigen en handel het daarna af via Dependency-matching.
Er wordt gemeld dat een dependency ontbreekt, maar die is lokaal geïnstalleerd
Controleer achtereenvolgens: de spelling van de pakketnaam, of de dependency in de node_modules van een submap staat, en of je de pagina moet verversen om opnieuw te detecteren.
De preview werkt, maar na het downloaden niet
De preview gebruikt de door het platform gematchte dependencies; na het downloaden gebruik je de versie van jouw project. Vergelijk met de dependency-eisen in de README en upgrade indien nodig het lokale pakket.
Uploaden en publiceren
Waarom komt mijn component niet in de openbare lijst
Mogelijk is het als dubbel beoordeeld, of voldoet de dependency-status niet aan de aanbevelingsvoorwaarden. Een dubbel component is alleen zichtbaar in "Mijn componenten".
Mag ik comp.json handmatig schrijven
Niet aanbevolen. Het bestand wordt door het platform gegenereerd en __id__ dient om de identiteit van het component te herkennen. Handmatig kapotmaken betekent dat het component bij een update niet meer wordt gevonden.
Bij het uploaden wordt gemeld dat bestanden de limiet overschrijden
Eén bestand ≤ 3 MB, totale grootte ≤ 10 MB, aantal bestanden ≤ 30. Comprimeer statische resources of splits het component.
Een React-component meldt no default export
De entry moet export default hebben. Bij alleen named exports is er geen component om te renderen.
Versies en updates
De CLI-upload wordt geweigerd
De lokale versie is niet groter dan de online versie. Hoog version in comp.json op; wijzig je alleen de omschrijving of previewconfiguratie, gebruik dan de updatepagina.
Blijft de oude versie bruikbaar na een update
Ja. Het platform bewaart historische versies en gebruikers kunnen oude versies blijven downloaden.
Moet ik opnieuw proberen na een time-out
Controleer eerst op het platform de nieuwste versie. Is die al bijgewerkt, probeer dan niet opnieuw om dubbele versies te voorkomen.
Studio
De preview blijft wit
Wacht eerst tot de dependencies geïnstalleerd zijn en controleer daarna het entry-bestand en de default export. Controleer bij een Web Component of de <script type="module"> in de HTML in de <body> staat.
De AI reageert niet
Het ingebouwde model van het platform vereist aanmelding; bij een eigen key moet je controleren of de key en het model beschikbaar zijn.
Na verversen is de werkruimte leeg
Controleer of je de werkruimte niet hebt verwijderd. Studio bewaart gegevens per werkruimte in de IndexedDB van de lokale browser en synchroniseert niet tussen apparaten.
Een terminalcommando wordt geblokkeerd
De terminal staat alleen npm install / npm i / npm add toe; andere commando's worden niet uitgevoerd.
Snel overzicht van foutmeldingen
| Melding | Betekenis | Oplossing |
|---|---|---|
comp-hub must be upgraded before it can start | De huidige CLI-versie moet worden geüpgraded | Installeer de nieuwste versie opnieuw |
Local version ... is the published version | Bij de CLI-upload is het versienummer niet opgehoogd | Wijzig het versienummer |
Component has no default export | De React-entry mist een default export | Wijzig naar export default |
Proxy not found | Het verzoek matcht geen proxyregel | Controleer de proxy-configuratie en het pad /__proxy__ |
Previewbestand bevat geen <script type="module"> | De preview-HTML van de Web Component mist een modulescript | Voeg het toe binnen de <body> |
| Ontbrekende dependency / dependency missing | De dependencies van het component zijn lokaal niet geïnstalleerd | Installeer ze in de hoofdmap van het project |
Terminologie
| Term | Betekenis |
|---|---|
| Component | Een map met een entry-bestand en resources; de mapnaam is de componentnaam |
| Werkruimte | Een zelfstandige snapshot van bestanden en gesprekken in Studio |
| Dependency-matching | De regels die bepalen of een lokale dependencyversie aan de eisen van het component voldoet |
| Precompileren | Het platform bundelt dependencies vooraf zodat de preview ze direct kan laden |
| mini / full | De preview in klein venster op de lijstkaart / de preview op volledig scherm op de detailpagina |
comp.json | Componentmetadata: __id__, name, version |
| Component-ID | De waarde van __id__, gebruikt om bij updates en imports hetzelfde component te herkennen |
| Semantische versie | major.minor.patch, respectievelijk voor breaking changes, nieuwe functionaliteit en fixes |
Omgeving en limieten
| Item | Limiet |
|---|---|
| Node.js | 16.0.0 of hoger |
| npm | 8.0.0 of hoger |
| Grootte per bestand | 3 MB |
| Totale grootte van het component | 10 MB |
| Aantal bestanden | 30 |
| Componentnaam | PascalCase of kebab-case, uniek binnen dezelfde ruimte |
| Aantal tags | Maximaal 5 |
Nog steeds niet opgelost
Verzamel informatie in deze volgorde; dat maakt het probleem snel lokaliseerbaar:
- De volledige foutmelding in de terminal (niet alleen de samenvatting op de laatste regel).
- De eerste fout in de browserconsole.
- Het framework en de bestandsnaam van de entry van het component.
- Of de lokale dependencyversies overeenkomen met de eisen in de README.