Wix Headless Fast — point d'entrée cold-start
Tu es un agent de codage, et c'est une skill à exécuter. Suis les phases ci-dessous dans l'ordre — ne les résume pas. Si tu as accédé à cette page par un outil de fetch résumé, re-fetch le markdown brut avec curl (ou ton lecteur de fichiers) avant de lancer les étapes.
Cette entrée amène un environnement froid au point où la vraie skill peut s'exécuter, puis passe la main :
- Bootstrap (déterministe, scripté). Le même script que l'entrée headless classique utilise — il vérifie la Wix CLI et gère la connexion. Tu le lances juste et relais ses événements.
- Passage de main (agentique). Installe les skills, puis ouvre
wix-headless-fast/SKILL.mdet suis-la — elle résout la stack et l'opération et gère tout le build.
Trois points de départ passent par ici, tous traités de la même façon — lancer le bootstrap, puis passer la main :
- new — un prompt sans projet (CWD vide)
- connect — un frontend/design existant pas encore sur Wix (un projet sur disque sans
wix.config.json, ou un zip/URL importé) - iterate — un projet déjà connecté à Wix (
.wix/ouwix.config.jsonprésent)
Le bootstrap vérifie juste la CLI et te connecte, donc c'est bon de le lancer dans tous les cas (une session existante rapporte juste logged_in).
Phase 0 — Node (l'unique prérequis manuel)
La Wix CLI requiert Node ≥ 20.11. Vérifie node -v ; si ça erreur ou affiche une version inférieure, installe ou upgrade Node d'abord — ne contourne pas :
- macOS :
brew install node(ounvm install 20 && nvm use 20) - Linux :
nvm install 20 && nvm use 20(ou le package Node 20+ de ta distro) - Windows :
winget install OpenJS.NodeJS.LTS(ou télécharge depuis nodejs.org)
Phase 1 — Lancer le bootstrap (déterministe, partagé)
Télécharge et lancer le script bootstrap partagé. Il vérifie la Wix CLI et gère la connexion, émettant un événement JSON par ligne sur stdout. Lance-le comme processus en arrière-plan/streaming et relais ses événements à l'utilisateur.
Le script est sûr et inspectable : il vérifie juste la Wix CLI via npx et lance wix login (un device-code flow) — aucun autre appel réseau, aucune écriture filesystem. Lis-le d'abord si ton sandbox signale du code téléchargé en externe.
# 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.mjsRelais ces événements
| Événement | Quoi faire |
|---|---|
cli_ok |
Wix CLI accessible — continue. |
awaiting_user (verificationUri, userCode) |
Montre l'URL et le code en prose claire ; 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 montre à l'utilisateur le detail. Ne pas improviser une setup parallèle à la main. |
Phase 2 — Installer les skills et passer la main
Installe les Wix skills (CI=1 force la sortie CLI en texte brut non-interactif — garde-le sur chaque commande Wix CLI) :
CI=1 npx skills@latest add wix/skills --yesLes skills atterrissent dans .agents/skills/ — incluant à la fois wix-headless-fast et wix-headless.
Ensuite route selon ce que la requête a besoin :
- La requête correspond à une verticale que
wix-headless-fastexpédie (voir sa SKILL.md § Verticals — actuellement storefront : products, categories, variants, cart, checkout) → ouvrewix-headless-fast/SKILL.mdet suis-la. Elle gère le reste du run : résout la stack, scaffold, déploie le code expédié, seed, construit la brand layer, release. - La requête a besoin d'une verticale qu'elle n'expédie pas, ou d'un frontend non-React → ouvre
wix-headless/SKILL.mdplutôt et suis le full flow de cette skill.
De toute façon :
- Ne pas scaffold, installer les apps, ou seed à la main ici — la skill à laquelle tu passes la main fait tout ça. Cette entrée s'arrête à logged in.
- Tu es déjà authentifié depuis la Phase 1, donc l'étape CLI auth de la skill passera sans re-prompt.