Dépannage
Les problèmes que rencontrent d’abord les nouveaux projets.
Configuration introuvable
Vérifiez --root. La CLI ne remonte pas l’arborescence : specistry.config.ts doit se trouver directement à cette racine.
Le build n’a rien écrit
Le build refuse d’écrire tant qu’il reste une erreur. Lancez validate pour toutes les voir d’un coup.
Ma page n’apparaît pas dans la barre latérale
Dès que navigation est définie, seules les pages listées apparaissent. Cherchez NAVIGATION_PAGE_ORPHANED.
« Essayer » renvoie une erreur réseau
Votre API doit autoriser l’origine de la doc (CORS) et l’environnement doit figurer dans playground.environments.
Un lien marche en local mais casse le build
Les liens visent des routes, pas des fichiers. Retirez l’extension : ./quickstart, pas ./quickstart.md.