Recommandez Lyvora à votre réseau et touchez jusqu’à 20 % de commission. Apport d’affaires : jusqu’à 20 %. Découvrir l’apport d’affaires

Écrire sur WhatsApp

Réponses générées par une IA (Mistral) à partir des pages du site. N’indiquez pas d’informations personnelles. Confidentialité

Assistant

Réserver un appel

Réponses générées par une IA (Mistral) à partir des pages du site. N’indiquez pas d’informations personnelles. Confidentialité

Académie · Liquid 5 min de lecturePublié le

Shopify CLI : développer un thème Shopify en local

Shopify CLI pour les thèmes : installer l'outil, récupérer un thème, le prévisualiser avec theme dev, le vérifier, puis l'envoyer sans risque.

Niveau
Avancé
Durée
45 min
Prérequis
un compte employé ou collaborateur autorisé à gérer les thèmes, une boutique de développement de préférence, un terminal
Outils
Shopify CLI, Node.js, Git, un éditeur de code
Sommaire6 parties
  1. Étape 1 — Installer Shopify CLI
  2. Étape 2 — Récupérer le thème avec shopify theme pull
  3. Étape 3 — Prévisualiser en local avec shopify theme dev
  4. Étape 4 — Vérifier avec shopify theme check
  5. Étape 5 — Envoyer le thème avec Shopify CLI, sans toucher au thème publié
  6. Questions fréquentes

L'essentiel

  • Shopify CLI s'installe avec npm et demande Node.js 22.12 ou plus récent.

  • shopify theme pull copie un thème de la boutique dans un dossier de votre poste.

  • shopify theme dev sert un aperçu sur http://127.0.0.1:9292, rechargé à chaque enregistrement, sans toucher au thème publié.

  • shopify theme check contrôle le Liquid et le JSON avant tout envoi.

  • shopify theme push --unpublished crée un thème non publié : les clients ne voient rien avant la publication.

Résumer avec ChatGPT Claude Perplexity

Shopify CLI est l'outil en ligne de commande de Shopify : pour un thème, il récupère les fichiers d'une boutique, les sert en aperçu local avec rechargement à chaud, les vérifie, puis les renvoie. Vous travaillez dans votre éditeur de code, avec Git pour l'historique, au lieu de l'éditeur de code de l'administration. Pour savoir quand un thème mérite ce travail, voir thème Shopify sur mesure ou thème du Theme Store.

Commandes vérifiées le 7 novembre 2026 avec Shopify CLI 5.0.1 (version publiée le 4 novembre), installée depuis npm : aide de chaque commande lue, shopify theme check lancé sur Dawn 16.1.1. Les commandes qui se connectent à une boutique (dev, pull, push) sont à tester sur une boutique de développement.

Étape 1 : Installer Shopify CLI

Shopify CLI est un paquet npm gratuit, sous licence MIT. Vérifiez d'abord Node.js et Git, puis installez l'outil pour tout le système :

Terminal
node -v
git --version
npm install -g @shopify/cli@latest
shopify version

Prérequis

Version demandée

Où le vérifier

Node.js

22.12 ou plus récent

node -v

Gestionnaire de paquets

npm, Yarn ou pnpm

npm -v

Git

2.28.0 ou plus récent

git --version

Ces versions minimales sont celles de la documentation de Shopify CLI, qui donne aussi les commandes pour Yarn, pnpm et Homebrew (sur macOS).

Résultat attendu

shopify version affiche un numéro de version : 5.0.1 au 7 novembre 2026.

Cycle de travail avec Shopify CLI en six étapes : installer avec npm, shopify theme pull, shopify theme dev sur http://127.0.0.1:9292, shopify theme check, shopify theme push --unpublished, puis shopify theme publish.
Six commandes couvrent le cycle complet, de la récupération du thème à sa publication.

Étape 2 : Récupérer le thème avec shopify theme pull

Créez un dossier pour le thème, placez-vous dedans, puis récupérez les fichiers. La première commande ouvre le navigateur pour vous connecter au compte Shopify de la boutique ; shopify theme list affiche les thèmes et leurs identifiants.

Terminal
mkdir mon-theme
cd mon-theme
shopify theme list --store ma-boutique
shopify theme pull --store ma-boutique --theme 123456789012
git init
git add .
git commit -m "Thème récupéré depuis la boutique"

Remplacez ma-boutique par le préfixe de votre adresse myshopify.com et 123456789012 par l'identifiant du thème. L'option --only limite la récupération à certains fichiers.

Bon à savoir

Pour partir de zéro plutôt que d'un thème existant, shopify theme init copie le thème Skeleton de Shopify, un squelette minimal. Les bases du langage sont dans le tutoriel Liquid : lire et modifier un thème.

Deux maquettes de maison identiques reliées par un fil blanc tendu, l'une avec une porte bleue.
Le thème local et le thème de développement restent reliés : chaque enregistrement passe de l'un à l'autre.

Étape 3 : Prévisualiser en local avec shopify theme dev

shopify theme dev envoie votre dossier dans un thème de développement, caché aux clients, et sert un aperçu local qui se met à jour à chaque enregistrement.

Terminal
shopify theme dev --store ma-boutique

D'après la référence de theme dev, le terminal affiche trois liens : l'aperçu local sur http://127.0.0.1:9292, l'éditeur de thème de ce thème de développement, et un lien d'aperçu à partager. Par défaut, les changements de CSS et de sections se rechargent sans recharger la page ; --live-reload full-page recharge la page entière. L'option --theme-editor-sync rapatrie dans vos fichiers JSON les réglages modifiés dans l'éditeur.

Schéma Shopify CLI : le dossier du thème sur le poste local, la bibliothèque de thèmes de la boutique avec un thème de développement caché, un thème non publié et le thème publié, reliés par theme dev, theme push et theme pull.
theme dev écrit dans un thème de développement ; le thème publié ne change qu'avec un push ou une publication.

Résultat attendu

Modifiez une couleur dans un fichier CSS du dossier assets : l'aperçu sur 127.0.0.1:9292 change sans que vous rechargiez la page.

Étape 4 : Vérifier avec shopify theme check

Theme Check lit tout le thème et signale les erreurs de Liquid, les filtres inconnus, les sections absentes citées par un modèle JSON et les mauvaises pratiques de performance.

Terminal
shopify theme check
shopify theme check --auto-correct

Un filtre mal orthographié sort en erreur UnknownFilter, avec le fichier et la ligne. --auto-correct corrige ce qui peut l'être sans risque ; le reste se corrige à la main. Par défaut, la commande échoue dès qu'une erreur apparaît (--fail-level error), ce qui la rend utilisable avant chaque envoi.

Attention

Lisez chaque erreur avant de corriger. Le 7 novembre 2026, Shopify CLI 5.0.1 relevait sur Dawn 16.1.1 (155 fichiers) 9 avertissements et 2 erreurs UnknownFilter sur applicable_disclosures, un filtre pourtant documenté par Shopify mais plus récent que la base de Theme Check. Dans ce cas, --strict bloquerait l'envoi à tort : mettez Shopify CLI à jour avant de conclure.

Étape 5 : Envoyer le thème avec Shopify CLI, sans toucher au thème publié

Envoyez le travail dans un nouveau thème non publié, relisez-le dans l'éditeur, puis publiez-le quand il est prêt.

Terminal
shopify theme push --store ma-boutique --unpublished --theme "Refonte fiche produit" --strict
shopify theme publish --store ma-boutique --theme "Refonte fiche produit"

--strict refuse l'envoi si Theme Check trouve une erreur. --nodelete évite de supprimer côté boutique les fichiers effacés en local.

Commande

Ce qu'elle fait

Effet sur les clients

shopify theme pull

Copie un thème de la boutique sur le poste

Aucun

shopify theme dev

Synchronise un thème de développement caché

Aucun

shopify theme check

Contrôle le thème en local

Aucun

shopify theme push --unpublished

Crée un thème non publié

Aucun

shopify theme push --live

Écrase le thème publié

Immédiat

shopify theme publish

Publie un thème

Immédiat

Attention

Un push vers le thème publié demande une confirmation dans le terminal, et l'option --allow-live dans un script. Un thème non publié se relit ; un thème écrasé se restaure moins facilement.

Check-list

À retenir

Shopify CLI ne remplace pas la relecture : il permet de travailler hors de la boutique en ligne, puis d'y envoyer un thème vérifié et relu.

Les modèles JSON que manipule l'outil sont détaillés dans Online Store 2.0 : sections et modèles JSON, et les profils capables de mener ce travail dans développeur, expert ou intégrateur Shopify. Votre thème mérite un vrai circuit de développement ? La page refonte Shopify présente notre façon de travailler ; pour en parler, écrivez-nous.

Questions fréquentes

Shopify CLI est-il gratuit ?

Oui. Shopify CLI est gratuit et son code est publié sous licence MIT sur GitHub, dans le dépôt Shopify/cli. L'outil s'installe avec npm, Yarn ou pnpm, ou avec Homebrew sur macOS. Il faut seulement un compte qui a accès à la boutique, ou un mot de passe généré par l'application Theme Access, pour les commandes qui s'y connectent.

Peut-on utiliser Shopify CLI sans compte employé sur la boutique ?

Oui, avec l'application Theme Access de Shopify. Le propriétaire de la boutique l'installe et génère un mot de passe pour le développeur, qui le passe à la commande avec l'option --password. Ce mot de passe ne donne accès qu'aux thèmes, en écriture, pas aux commandes ni aux clients ; supprimer le mot de passe dans l'application retire l'accès.

Comment relier un thème Shopify à GitHub ?

Shopify propose une intégration GitHub dans la bibliothèque de thèmes : une branche d'un dépôt devient un thème de la boutique, et chaque commit sur cette branche le met à jour. Shopify CLI la complète : vous développez en local avec shopify theme dev, puis vous poussez sur la branche. Les modifications faites dans l'éditeur de thème sont renvoyées dans la branche par Shopify.

shopify theme dev modifie-t-il la boutique en ligne ?

Non. La commande travaille dans un thème de développement, caché aux clients, qui n'apparaît pas comme thème publié. Le thème en ligne ne change que si vous lancez un push vers lui ou une publication. L'aperçu local utilise les vraies données de la boutique : produits, collections, prix.

Écrit par

Ylan ColsonFondateur de Lyvora

Ylan Colson a fondé Lyvora à Paris en 2024. Le studio conçoit et développe des sites vitrines et e‑commerce sur‑mesure, sur Shopify et sur Webcosa.

Le studioInstagram

Partager