Dépannage

Avant de réessayer, conservez le diff actuel et identifiez l'étape qui a échoué : inspection, exécution à sec, installation de dépendances, application source ou validation d'application. Comparez votre application avec la Compatibilité testée; ne forcez pas une configuration non prise en charge par l'installateur.

L'élément public ou l'URL ne peut pas être résoluLien vers la section

Les exemples d'adresses publiques dépendent d'une vérification séparée de la disponibilité des miroirs marketing révisés par l'homme. Un test client local réussi ne prouve pas que le manifeste public, les fichiers sources ou la dépendance de base peuvent être récupérés.

Vérifiez l'adresse exacte de l'article qualifié à partir du guide d'installation. Ne remplacez pas le monorepo privé, une URL de manifeste de source brute, un nom d'élément nu, un @pycolors espace de nommage, ou un point de terminaison hébergé supposé. Vérifiez que le miroir public contient les deux éléments et leurs fichiers référencés lors de la révision en cours d'inspection. Une défaillance du réseau en amont ou de la limite de débit n'est pas une raison pour modifier la cible source ou ajouter des informations d'identification.

N'ajoutez pas de token de production pour faire fonctionner un flux de travail public sans informations d'identification. Jusqu'à ce que la livraison publique soit vérifiée, utilisez manuel source copy.

La configuration est incompatibleLien vers la section

Revoir l'existant de l'app components.json: radix-nova, TypeScript/TSX, Lucide, variables CSS, couleur de base du zinc, pas de préfixe Tailwind, et l'emplacement de feuille de style documenté. Comparez-le avec le Exemple de configuration. N'exécutez pas une initialisation forcée ou ne changez pas de bibliothèques primitives juste pour que l'installation continue.

Les tests ont une garde de pré-vol pour les configurations non prises en charge. C'est l'outil de test de dépôt, pas un public doctor commande ou une garantie que la CLI amont refuse tout projet non supporté sans écriture. Utilisez l'installation manuelle lorsque la configuration est en dehors de la matrice.

Les alias échouent ou atterrissent dans le mauvais espace de travailLien vers la section

L'app aliases.components doit pointer vers @/components, et sa propre configuration TypeScript et bundler doit résoudre @ à cette app src. Le fichier copié attendu est src/components/blocks/feedback-empty-state-panel/index.tsx par rapport à l'app consommatrice.

Pour l'espace de travail testé, exécutez l'interface de ligne de commande apps/web et de réconcilier le fichier de verrouillage partagé à partir de la racine de l'espace de travail. Confirmer les dépendances appartiennent à apps/web, pas le paquet racine ou un frère non touché. Arrêtez et examinez les modifications inattendues de l'espace de travail avant de relancer la commande. Les alias de paquets partagés et les configurations TypeScript héritées nécessitent une validation distincte.

Dépendances ou installation gelée échouentLien vers la section

Confirmez le nœud 24, pnpm 10.32.1, l'interface de ligne de commande shadcn épinglée et les versions exactes des paquets testés. Vérifiez que les dépendances sont résolues à partir de npm public, pas workspace:, file:ou link: des références copiées d'un monorepo.

Un paquet npm non disponible ou une défaillance réseau est une véritable installation défaillante ; ne le remplacez pas par un paquet privé ou emprunté node_modules Arbre. Préservez l'erreur et réessayez seulement après avoir identifié la cause.

Après un changement intentionnel de dépendance du Registre, utilisez le Réconciliation des fichiers verrouillés, examinez le résultat, puis vérifiez une installation gelée. Ne supprimez pas le fichier de verrouillage, ne désactivez pas les installations gelées dans CI ou n'acceptez pas les mises à niveau non liées pour masquer l'erreur.

Les tokens, les couleurs ou les styles d'état Radix sont manquantsLien vers la section

Vérifiez que le framework importe la feuille de style globale et que Tailwind 4/PostCSS fonctionne déjà. La base doit ajouter exactement une importation de token et un package d'interface utilisateur @source directive. Ce dernier est relatif à la feuille de style, pas au répertoire de travail du terminal.

La voie zéro-édition attend src/app/globals.css ou src/styles/globals.css à l'intérieur de l'application, avec cette application node_modules/@pycolors/ui. Une profondeur de feuille de style différente est en dehors du flux testé. Comparez la configuration avec Installation de l'interface utilisateur; ne copiez pas la source du package de l'interface utilisateur ou les couleurs du code dur pour masquer l'intégration de token manquante.

Une installation répétée affiche des modifications ou une invite d'écrasementLien vers la section

Ne supposez pas qu'une installation répétée est une non-op. Les plages de paquets et le fichier de verrouillage peuvent changer au fur et à mesure que la base est réappliquée. Refuser l'écrasement pour la source personnalisée, inspecter le diff complet et suivre Propriété et mises à jour. Un écrasement refusé protège le fichier Block, pas nécessairement le fichier lockfile.

Types, peluches, ou la construction de la production échouentLien vers la section

Vérifiez le chemin d'importation installé, public @pycolors/ui les exportations, et vos accessoires appartenant aux consommateurs et vos actions contre Guide du panneau d'état vide. Ne pas importer @pycolors/ui/src/*, @pycolors/ui/dist/*, ou des modules d'application privés pour faire passer la construction.

Le formatage est une étape de consommation explicite après l'installation. Exécutez le formatage, les peluches, les types stricts, les tests et votre production à partir de la source installée. La matrice valide Next.js avec Webpack et Vite avec sa construction de production; d'autres bundlesers ou combinaisons de versions nécessitent leurs propres preuves. Ne pas affaiblir TypeScript strict, supprimer les tests ou supprimer les échecs de construction.

Enfin, examinez l'accès au clavier, le focus visible, la mise en page mobile et votre comportement d'action réel dans un navigateur. Un test de rendu statique ne peut pas valider l'interaction complète de votre application.

Partager une reproduction bornéeLien vers la section

Enregistrez l'élément et la révision inspectée, les versions Node/pnpm/shadcn, le framework, la position de l'espace de travail, la commande et l'erreur d'échec expurgées, et les chemins ont changé. Indiquez si l'échec se produit avec un artefact local ou l'adresse GitHub publique. Partagez une reproduction minimale sans informations d'identification, source privée, données client ou fichiers d'environnement.

Pour un repli sûr, utilisez Installation manuelle des blocs. Pour l'enlèvement, suivez rollback et nettoyage.