Skill Wix Headless

Tu es un agent de codage, et ceci est un skill à exécuter. Suis les phases ci-dessous dans l'ordre — ne les résume pas. Si tu as accédé à cette page via un outil de fetch résumé, re-fetch le markdown brut avec curl (ou ton lecteur de fichier) avant de lancer les étapes.

Ce skill comporte deux phases :

Bootstrap (déterministe, scriptée). Un seul script vérifie ton environnement (la Wix CLI) et gère la connexion, pour que la construction commence depuis un état authentifié et fiable. Tu l'exécutes simplement et relais ses événements.
Build (agentic). Configure le projet, puis connecte la ou les Business Solution(s) que le prompt ou le design implique.

Ne lance pas manuellement toi-même la connexion de la Phase 1 — le script la rend déterministe. Garde ton jugement pour la Phase 2.

Phase 0 — Node (le seul prérequis manuel)

La Wix CLI nécessite Node ≥ 20.11. Vérifie-le :

node -v

Si cela produit une erreur (Node non installé) ou affiche une version inférieure à 20.11, installe ou mets à jour Node et revérifie — n'essaie pas de le contourner :

macOS : brew install node (ou nvm install 20 && nvm use 20)
Linux : nvm install 20 && nvm use 20 (ou le paquet Node 20+ de ta distribution)
Windows : winget install OpenJS.NodeJS.LTS (ou télécharge depuis nodejs.org)

Phase 1 — Lancer le bootstrap (déterministe)

Télécharge le script de bootstrap, puis exécute-le. Il vérifie la Wix CLI et gère la connexion, émettant un événement JSON par ligne sur stdout. Exécute-le comme un processus en arrière-plan/streaming et relais ses événements à l'utilisateur.

# macOS/Linux :
curl -fsSL -O https://www.wix.com/skills/headless/entry/bootstrap.mjs
# Windows PowerShell :
iwr https://www.wix.com/skills/headless/entry/bootstrap.mjs -OutFile bootstrap.mjs

node bootstrap.mjs

Relais ces événements

Le script émet un objet JSON par ligne :

Événement	Quoi faire
`cli_ok`	Wix CLI accessible — continue.
`awaiting_user` (`verificationUri`, `userCode`)	Affiche l'URL et le code en prose simple ; attends que l'utilisateur termine la connexion dans son navigateur.
`logged_in` / `success`	Connexion faite — continue.
`cli_unreachable` / `login_failed` (avec `detail`)	Arrête et affiche le `detail` à l'utilisateur. Ne contourne pas par une configuration parallèle manuelle.

Choisis le mode

Une fois connecté, configure le projet selon ta situation :

Continuer un site déployé — l'utilisateur t'a donné une URL de téléchargement Wix, ou tu es déjà dans un dossier avec un wix.config.json :

Ajuste wix.config.json (définis outputDirectory) en conséquence.
Release le projet : wix release.

Connecter une base de code existante à un nouveau site Wix — tu es dans un répertoire non vide sans wix.config.json :

Initialise un nouveau site Wix : npx @wix/create-new@latest init.
Ajuste wix.config.json (définis outputDirectory) en conséquence.
Build le projet (si nécessaire).
Release le projet : wix release.

Démarrer de zéro — un prompt sans projet existant (répertoire vide). Déduis un nom de marque humain et un nom de dossier en kebab-case du prompt, puis crée un nouveau projet Wix CLI Headless :

npm create @wix/new@latest headless -- \
  --business-name "<Brand>" \
  --folder-name "<brand-slug>" \
  --site-template "blank" \
  --no-publish

<business-name> doit contenir au moins une lettre ou un chiffre ; <folder-name> doit correspondre à ^[a-z0-9][a-z0-9-]*$ (par ex. Acme Bakery → acme-bakery). Demande à l'utilisateur si tu ne peux pas déduire un nom sensé.

Phase 2 — Connecter une Business Solution (agentic)

Installe les skills Wix Headless

wix skills add
# Fallback si 'wix skills' n'est pas enregistré pour ce type de projet :
npx skills@latest add wix/skills --yes

Les skills se posent dans .agents/skills/.

Prépare le site Wix

Suis le skill wix-manage pour ensemencer les données et installer la Business Solution nécessaire.

Chaque appel API Wix s'authentifie avec @wix/cli + curl :

Authorization: Bearer $(npx @wix/cli@latest token --site "$SITE_ID")
wix-site-id: $SITE_ID

Implémente la logique de Business Solution

Cela dépend du mode que tu as choisi en Phase 1.

Continuer un projet / site existant :

Implémente la Business Solution nécessaire en suivant son skill dédié dans references/<business-solution>. Dans ce flux, le temps jusqu'au succès compte — implémente seulement la fonctionnalité nécessaire, sans cas limites, fallbacks ou vérifications supplémentaires. Reste minimal et offre à l'utilisateur un point de départ rapide et solide pour sa connexion Wix ; la profondeur viendra dans les itérations suivantes.

Démarrer de zéro :

Utilise references/DISCOVERY-create.md.

Rapporte le résultat

Rapporte le site live à l'utilisateur seulement après la première itération réelle et précieuse — la Business Solution est connectée et le site affiche du contenu réel, pas le template de démarrage. Dis-lui alors : le site est live (donne l'URL live), le dashboard est à https://manage.wix.com/dashboard/<siteId>, et le projet est configuré localement (projectDir). Ne communique pas l'URL avant cela — un site fraîchement scaffoldé est un template de démarrage vide, et partager ce lien présente le mauvais contenu comme « ton site ».

Si quelque chose bloque la Business Solution et que tu es véritablement bloqué après quelques vraies tentatives pour le corriger, ne le cache pas : rapporte le site et les URLs comme ci-dessus, mais dis clairement que la connexion n'est pas encore terminée et quel est le problème en attente. Ne présente jamais un site à moitié connecté comme terminé.

wix-headless-entry