Dépannage

Quelque chose ne marche pas comme prévu ? Retrouve ton cas ci-dessous. Dans le doute, souviens-toi que rien n’est jamais perdu : chaque modification est une version, et tu peux revenir à n’importe laquelle.

L’aperçu reste blanc ou ne s’affiche pas

Commence par regarder ce qu’affiche le panneau de l’aperçu.

Ce que tu vois	Ce qui se passe	Que faire
Highwind construit ton app	L’agent écrit la première version : l’app s’affiche dès que la page existe.	Attendre quelques secondes.
Démarrage de l’aperçu…	L’environnement du projet se réveille (voir ci-dessous).	Attendre ; en général quelques secondes.
Préparation de la version N…	Tu consultes une ancienne version, qui démarre dans un environnement temporaire.	Attendre, ou revenir à la version actuelle.
Un message d’erreur et Réessayer	L’aperçu n’a pas pu démarrer.	Cliquer sur Réessayer.
Une page vide, sans message	L’app a planté au chargement, ou tu es sur une adresse qui n’existe pas.	Voir les étapes ci-dessous.

L’environnement se réveille

Chaque projet tourne dans son propre environnement isolé. Pour ne pas consommer de ressources inutilement, il est mis en veille après 15 minutes sans activité : en rouvrant le projet, l’aperçu redémarre en quelques secondes, avec tous tes fichiers. Après 24 heures sans activité, l’environnement est recréé à partir de la dernière version enregistrée, ce qui peut prendre un peu plus longtemps. Tu n’as rien à faire : c’est automatique. Si tu envoies une demande à ce moment-là, le chat affiche Préparation de l’environnement… le temps que l’agent démarre.

Une page vide sans message

Clique sur Recharger (la flèche circulaire dans la barre de l’aperçu).
Vérifie l’adresse dans la barre de l’aperçu : si tu es sur une page qui n’existe pas, efface le chemin et tape / pour revenir à l’accueil de l’app.
Si un bandeau rouge L’app a rencontré une erreur apparaît en bas de l’aperçu (souvent de type Page blanche), clique sur Corriger (voir la section suivante).
Si rien ne change, reviens à la version précédente depuis le badge de version, puis redemande le changement autrement.

Le bandeau d’erreur de l’aperçu et le bouton Corriger

Highwind surveille l’aperçu pendant que tu l’utilises. Quand l’app rencontre un problème, un bandeau rouge L’app a rencontré une erreur (ou L’app a rencontré N erreurs) s’affiche en bas de l’aperçu, avec le type d’erreur :

Exception : une erreur dans le code pendant l’exécution ;
Promesse rejetée : une opération en arrière-plan qui a échoué (souvent un appel réseau) ;
console.error : une erreur signalée par l’app elle-même ;
Compilation : le code ne compile pas ;
Page blanche : rien ne s’affiche.

Trois boutons :

Détails : affiche le message complet de chaque erreur ;
Corriger : envoie les erreurs à l’agent, qui les répare. C’est une demande comme une autre : elle crée une version et consomme des crédits ;
Ignorer (la croix) : masque le bandeau.

Si l’erreur revient après Corriger, décris à l’agent ce que tu faisais quand elle est apparue (« l’erreur arrive quand je clique sur Valider le panier avec un panier vide »), ou reviens à la dernière version qui marchait.

L’agent s’est arrêté ou a échoué

Ce que tu vois	Ce qui s’est passé	Que faire
Tu as cliqué sur Arrêter l’agent	La demande est interrompue. Le travail déjà fait est gardé dans une version.	Relancer avec une demande plus précise. Une demande arrêtée avant qu’un fichier change ne coûte rien.
« Une erreur est survenue : … »	Un problème technique a interrompu la demande.	Une demande en erreur n’est pas décomptée. Renvoie ta demande, ou écris « Continue ».
« J’ai arrêté ce run : il a atteint la limite de 12 crédits par demande… »	La demande était trop grosse. Le travail fait est enregistré.	Découpe la suite en demandes plus petites.
Étape Des erreurs restent à corriger à la fin	L’agent a fait ses passes de correction sans tout régler.	Demande « Corrige les erreurs restantes », ou utilise Corriger dans l’aperçu.
« L’agent travaille déjà sur un autre de tes projets : attends qu’il ait fini. »	L’agent ne travaille que sur un projet à la fois par compte.	Attendre la fin de l’autre demande, ou l’arrêter.
« Trop de messages pour l’instant : réessaie dans … »	Tu as atteint la limite de messages par heure.	Réessayer après le délai indiqué. Le mode Design reste disponible.
« Highwind est temporairement en pause… »	La création d’apps est suspendue un moment pour tout le monde.	Réessayer un peu plus tard. Tes apps publiées restent en ligne.
« Enregistre ou annule tes modifications de code avant d’envoyer un message. »	Tu as des modifications non enregistrées dans l’onglet Code.	Enregistrer (`Ctrl` + `S`) ou Annuler dans l’onglet Code.

Plus de crédits

Quand ton solde est épuisé, la zone de saisie est bloquée et un message indique quand les crédits reviennent : « Plus de crédits pour aujourd’hui : les prochains arrivent à … » (ou « Plus de crédits ce mois-ci : les prochains arrivent le … » si tu as atteint le plafond mensuel).

Les crédits du jour reviennent chaque nuit à minuit (heure UTC), sans report de ceux non utilisés.
Le plafond mensuel se réinitialise le 1er du mois.
Les crédits bonus éventuels, sans expiration, sont utilisés une fois ceux du jour épuisés.

En attendant, tout ce qui ne fait pas travailler l’agent reste disponible : le mode Design, l’édition du code dans l’onglet Code, les versions, la publication et la mise à jour de tes apps. Tes apps publiées restent en ligne. Voir Crédits.

Le site publié est différent de l’aperçu

Vérifie que la dernière version est publiée. Ouvre le menu Publier : s’il indique « La vN n’est pas encore en ligne. », clique sur Mettre à jour. L’aperçu montre toujours la dernière version, le site en ligne montre la dernière version publiée.
Recharge la page du site dans ton navigateur (en vidant le cache si besoin) pour être sûr de voir la nouvelle version.
Si la publication a échoué, le menu affiche « Échec de la publication : … » avec la raison (par exemple « Le build a échoué »). Demande à l’agent de corriger l’erreur, puis republie.
Si une fonction qui passe par le serveur (formulaire, envoi d’e-mail, appel à un service) marche dans l’aperçu mais pas en ligne, ouvre les logs : bouton Logs du serveur dans la barre de l’aperçu, puis onglet En ligne. Tu y vois chaque appel aux routes /api de l’app publiée et ses erreurs, sur les 24 dernières heures, avec quelques secondes de retard. Tu peux aussi écrire à l’agent : « Ça marche dans l’aperçu mais pas en ligne » ; il sait lire ces mêmes logs.

Autres différences normales ou fréquentes :

Le badge Highwind : les apps publiées affichent un petit badge « Made with Highwind ».
L’onglet En ligne est vide : « Cette app n’est pas encore publiée » (publie-la d’abord) ou « L’app publiée n’a pas de serveur (site statique) » (elle n’a pas de routes /api, donc pas de logs en ligne).
Trop de requêtes : les routes /api d’une app publiée sont limitées par visiteur et par minute pour éviter les abus. Au-delà, elles répondent une erreur pendant une minute.
Une clé changée : une clé modifiée dans les secrets du projet s’applique aussi à l’app en ligne, sans republier.
Publication bloquée : si l’app ressemble à une page de hameçonnage, ou si sa base de données a une faille critique, la publication est refusée. Pour les failles, le menu Publier liste les problèmes avec Corriger avec l’agent. Voir Publier.

Une clé de connecteur manque ou est refusée

Quand une fonction a besoin d’un service externe, l’agent affiche une carte dans le chat : L’agent a besoin d’une clé ou L’agent a besoin de ta connexion …. Tu peux y choisir Utiliser une connexion de ton compte (une clé déjà enregistrée) ou coller une nouvelle clé, puis Ajouter. La clé est chiffrée et jamais montrée à l’agent.

L’app est construite quand même, mais la fonction concernée répond une erreur claire tant que la clé manque. Pour l’ajouter plus tard : Paramètres du projet → Connecteurs (ou → Secrets pour une clé hors catalogue). Le lien Où trouver la clé t’indique où la récupérer chez le service.

Problèmes de connexion à Kameleoon, Notion, Linear ou Figma

Les sources de contexte et Kameleoon se connectent depuis la page Connecteurs de la barre latérale.

Notion ou Linear : la connexion se fait dans une fenêtre. Si elle ne s’ouvre pas, autorise les fenêtres surgissantes pour highwind.app. Si l’agent t’indique qu’une source est injoignable, ouvre sa fiche, clique sur Déconnecter puis Connecter pour la reconnecter.
Figma : colle un jeton d’accès personnel créé dans Figma (Paramètres → Sécurité → Jetons d’accès personnels) avec les droits « File content » et « Current user » en lecture seule.
Kameleoon : colle le Client ID et le Client secret de ton compte (dans Kameleoon : ton profil en haut à droite → Mon profil → « Voir mes identifiants API »). L’agent a les mêmes droits que ton compte.

Erreurs fréquentes avec Kameleoon :

Symptôme	Cause	Solution
Le mode Kameleoon n’apparaît pas dans le panneau de gauche	Il faut à la fois le compte Kameleoon connecté et le projet relié à un site (code du site ajouté par le connecteur Kameleoon de l’app).	Connecte le compte sur la page Connecteurs, puis demande à l’agent d’installer Kameleoon dans l’app.
Lecture seule dans le panneau	Les modifications ne sont pas autorisées.	Active Autoriser l’agent à modifier dans la source Kameleoon (page Connecteurs).
Limite d’appels atteinte	L’API Kameleoon limite le nombre d’appels par minute.	Attendre une minute, puis Actualiser.
Accès refusé par Kameleoon	Ton compte Kameleoon n’a pas le droit nécessaire.	Vérifier tes droits dans Kameleoon.
Site introuvable	Le code du site du projet n’appartient pas à ce compte Kameleoon.	Vérifier le code du site dans Paramètres du projet → Connecteurs.
« Les résultats sont encore en calcul »	Kameleoon calcule les résultats en différé.	Réessayer dans un instant.

Pour une app React, pense aussi à activer la prise en charge des sites dynamiques dans ton projet Kameleoon. Voir Configurer Kameleoon.

Le mode Design ou la sélection ne marchent pas

« L’aperçu n’est pas encore prêt » : attends que l’aperçu soit chargé.
« Attends que l’agent ait terminé » : le mode Design est indisponible pendant que l’agent travaille.
« Indisponible sur une ancienne version » : reviens à la version actuelle.
« Cet élément a changé dans le code : clique de nouveau dessus dans l’aperçu » : l’agent ou toi avez modifié le fichier entre-temps ; sélectionne l’élément à nouveau.
« Le style de cet élément est calculé dans le code » : ce réglage n’est pas modifiable directement ; clique sur Demander à l’agent.
Sur un projet ancien, certaines fonctions (sélection, mode Design, aperçu du mode sombre) arrivent quand son environnement est recréé, après 24 heures sans activité.

Restaurer une version

Chaque demande à l’agent, chaque séance de retouches et chaque enregistrement de code crée une version. Pour revenir en arrière :

Clique sur le badge de version (par exemple v7) à côté du nom du projet, en haut de l’éditeur : l’Historique s’ouvre. Tu peux aussi cliquer sur la pastille de version sous une réponse de l’agent.
Choisis la version voulue. L’aperçu l’affiche en lecture seule (le badge change de couleur).
Vérifie que c’est bien celle-là, puis clique sur Restaurer cette version.
Highwind crée une nouvelle version identique à l’ancienne, et un message le confirme dans le chat. Les versions intermédiaires restent dans l’historique : tu peux encore y revenir.

Voir Versions.

Autres situations

Le lien de connexion est invalide ou a expiré : redemande un lien depuis la page Se connecter et ouvre-le dans le même navigateur.
« Le compte … n’a pas encore accès » : Highwind est sur invitation ; demande une invitation depuis cet écran.
« Image trop lourde (5 Mo au plus) » : réduis l’image avant de l’envoyer. Un projet peut contenir 100 images au plus.
La base de données de l’app a été supprimée : tant qu’une app n’est pas publiée, sa base est supprimée après 24 heures sans activité. Réactive le backend dans Paramètres du projet → Backend : les tables sont recréées, pas les données. Voir Base de données.

Voir aussi

Questions fréquentesLes réponses aux questions courantes.

L'aperçuBarre d'adresse, tailles d'écran, logs.

Serveur de l'appRoutes /api, logs et limites.

Mises à jourPublier une nouvelle version de ton app.