💡 Recommandation : Pour de meilleurs résultats, utilisez le modèle Claude Opus 4.5 (Thinking) dans WindSurf. C'est le modèle le plus performant pour comprendre et modifier du code Shopify de manière fiable.
🎉 WindSurf est installé — Comment gérer les problèmes à partir de maintenant
À partir de cette étape, vous pouvez demander à l'IA de WindSurf de vous aider en cas de problème.
L'IA est capable de résoudre quasiment tous les problèmes, y compris ceux liés à votre machine (erreurs terminal, configuration, dépendances…).
Comment faire : Décrivez simplement votre problème dans le panneau Cascade (l'IA). Copiez-collez l'erreur si besoin. L'IA analysera et proposera une solution.
1.1 Ouvrir le projet dans WindSurf
Ouvrir WindSurf
Cliquer sur File > Open Folder
Sélectionner le dossier du thème
1.2 Lancer le thème en local
Ouvrir le terminal intégré de WindSurf (menu Terminal > New Terminal)
Lancer :
shopify theme dev
Une URL de preview s'affiche dans le terminal.
1.3 Vérifier que ça fonctionne
Ouvrir l'URL affichée dans le navigateur
Vérifier que le site se charge normalement
Les changements locaux apparaissent après un rafraîchissement
2
Suivre et valider les changements avec le versioning
Objectif : garder le contrôle sur ce que modifie l'IA, sans utiliser Git en ligne de commande.
2.1 Ouvrir l'onglet "Source Control"
Dans WindSurf :
Ouvrir le panneau latéral gauche
Cliquer sur l'icône de branches (Source Control)
C'est ici que WindSurf liste tous les fichiers modifiés
ℹ️ À partir de maintenant :
Chaque modification apparaît automatiquement
Rien n'est validé tant que vous ne le décidez pas
2.2 Principe de base (très important)
L'IA modifie des fichiers
WindSurf vous montre exactement ce qui a changé
Vous décidez :
Soit de garder les changements
Soit de annuler(clic droit > Discard Changes)
⚠️ Important : Rien n'est envoyé sur Shopify tant que ce n'est pas validé et déployé.
3
Faire des modifications avec l'IA
Objectif : demander des changements sans coder soi-même.
Comment faire simplement
Ouvrir le panneau Cascade (IA) dans WindSurf
Expliquer clairement ce que vous voulez à l'IA Exemple : "Ajouter un bloc FAQ sur la page produit"
Laisser l'IA modifier le code
🎯 Conseil : Soyez précis dans vos demandes. Plus votre description est claire, meilleur sera le résultat. Mentionnez la page concernée, le style souhaité, etc.
3.1 Vérifier les changements
Dans l'onglet Source Control :
Regarder la liste des fichiers modifiés
Cliquer sur un fichier pour voir les changements (diff)
Vérifier rapidement que ça correspond à la demande
⚠️ Si quelque chose semble bizarre ou trop complexe :
Ne pas valider
Annuler les changements (clic droit > Discard Changes)
Reformuler votre demande à l'IA
4
Tester en local avant validation
Objectif : vérifier que rien n'est cassé.
Checklist simple
Le site se charge toujours
La page concernée fonctionne
Rien d'étrange ailleurs sur le site
Pas d'erreur visible dans la console (F12)
⚠️ Si ce n'est pas OK :
Annuler les changements dans le panneau Source Control
Demander à l'IA de corriger
5
Valider les changements (commit)
Objectif : enregistrer officiellement une version propre.
Dans le panneau Source Control :
Vérifier que tout est OK
Cliquer sur le + pour "stager" les fichiers (ou Stage All)
Ajouter un message simple dans le champ texte Exemple : "Ajout bloc FAQ page produit"
Cliquer sur Commit (✓)
👉 À partir de là : les changements sont "propres et validés" dans l'historique Git local.
6
Déployer le thème sur Shopify
Objectif : envoyer la version validée sur Shopify.
Dans le terminal WindSurf :
shopify theme push
Recommandations
Déployer vers un thème de test/preview si possible
Vérifier rapidement en ligne sur ce thème de test
Publier le thème seulement si tout est OK
💡 Astuce : Vous pouvez créer un thème de preview sur Shopify pour tester sans impacter la production. Utilisez shopify theme push --unpublished pour créer un nouveau thème de test.