---
title: "Shopify CLI : développer un thème Shopify en local — Lyvora"
description: "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."
url: "https://www.lyvora.agency/blog/academie/shopify-cli-theme-dev"
lang: "fr-FR"
---

[Académie · Liquid](https://www.lyvora.agency/blog/academie) 5 min de lecturePublié le 4 novembre 2026

# 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](https://shopify.dev/docs/api/shopify-cli), Node.js, Git, un éditeur de code

[**Ylan Colson**Fondateur de Lyvora](https://www.lyvora.agency/agence)

[Partager sur LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev&text=Shopify+CLI%C2%A0%3A+d%C3%A9velopper+un+th%C3%A8me+Shopify+en+local)

**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](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](https://chatgpt.com/?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev) [Claude](https://claude.ai/new?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev) [Perplexity](https://www.perplexity.ai/search?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev)

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](https://www.lyvora.agency/blog/comparatifs/theme-shopify-sur-mesure).

_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](https://shopify.dev/docs/api/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.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/shopify-cli-theme-dev-cycle-kjmu3f.avif?width=1080&quality=85&resize=contain)

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](https://www.lyvora.agency/blog/academie/liquid-shopify).

![Deux maquettes de maison identiques reliées par un fil blanc tendu, l'une avec une porte bleue.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/shopify-cli-theme-dev-illustration-1d9psl.webp?width=1080&quality=85&resize=contain)

Le thème local et le thème de développement restent reliés : chaque enregistrement passe de l'un à l'autre.

Le service

Design UI/UX Shopify

Une interface Shopify dessinée pour votre marque et pour votre catalogue.

[Découvrir le service](https://www.lyvora.agency/design-ui-ux-shopify)[Voir une boutique livrée](https://www.lyvora.agency/maison-trungadi)[Recevoir une estimation écrite](https://www.lyvora.agency/contact?parcours=estimation&prestation=design-ui-ux#contact)

## É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](https://shopify.dev/docs/api/shopify-cli/theme/theme-dev), le terminal affiche trois liens : l'aperçu local sur [http://127.0.0.1:9292](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.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/shopify-cli-theme-dev-environnements-irh1dr.avif?width=1080&quality=85&resize=contain)

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

- Node.js 22.12 ou plus récent, Git et Shopify CLI installés
- Le thème est récupéré et suivi par Git
- L'aperçu local se recharge à l'enregistrement
- Theme Check ne signale aucune erreur
- Le travail part dans un thème non publié, relu avant publication

À 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](https://www.lyvora.agency/blog/academie/shopify-online-store-2-0), et les profils capables de mener ce travail dans [développeur, expert ou intégrateur Shopify](https://www.lyvora.agency/blog/comparatifs/developpeur-shopify-expert-integrateur). Votre thème mérite un vrai circuit de développement ? La page [refonte Shopify](https://www.lyvora.agency/refonte-shopify) présente notre façon de travailler ; pour en parler, [écrivez-nous](https://www.lyvora.agency/contact).

Votre projet

Un site Shopify ou Webcosa à concevoir ?

Parlez-nous de votre marque, de votre catalogue et de votre calendrier. Le premier échange est un appel de 30 minutes, par téléphone, à l’heure de Paris.

[Recevoir une estimation écrite](https://www.lyvora.agency/contact?parcours=estimation&prestation=design-ui-ux#contact)[Réserver un appel de 30 min](https://www.lyvora.agency/contact?parcours=appel&prestation=design-ui-ux#contact)

[Design UI/UX Shopify](https://www.lyvora.agency/design-ui-ux-shopify)[Voir une boutique livrée](https://www.lyvora.agency/maison-trungadi)

## 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 studio](https://www.lyvora.agency/agence)[Instagram](https://www.instagram.com/ylan.ecom/)

Partager[Partager sur LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fshopify-cli-theme-dev&text=Shopify+CLI%C2%A0%3A+d%C3%A9velopper+un+th%C3%A8me+Shopify+en+local)

Un projet Shopify ou Webcosa ?

Vous échangez directement avec l’équipe qui conçoit et développe votre site.

[Réserver un appel de 30 min](https://www.lyvora.agency/contact?parcours=appel&prestation=design-ui-ux#contact) [contact@lyvora.agency](mailto:contact@lyvora.agency)

Nos réalisations

## Des boutiques livrées par le studio

[Toutes les réalisations](https://www.lyvora.agency/realisations)

- [![Colliers Mayalice portés : rang de perles et chaîne dorée à breloques, sur un haut en crochet écru](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/mayalice-couverture-irysok.avif?width=960&quality=85&resize=contain)Bijoux personnalisésRefonte · ShopifyMayaliceRefonte luxe minimaliste et six configurateurs produits pour composer son bijou en direct.](https://www.lyvora.agency/mayalice)
- [![Peignoir Nouvelle Vague crème de Maison Trungadi porté en extérieur, dans la verdure](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/maison-trungadi-couverture-qympx5.avif?width=960&quality=85&resize=contain)Linge de bainMigration et refonte · ShopifyMaison TrungadiPeignoirs et linge de bain confectionnés en Toscane : une boutique à la hauteur des matières.](https://www.lyvora.agency/maison-trungadi)
- [![Bougie artisanale Candle’lice tenue en main au-dessus d’une planche en bois parsemée de guimauves](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/candlelice-couverture-207lru.avif?width=960&quality=85&resize=contain)Bougies artisanalesMigration et refonte · ShopifyCandle’liceDes bougies atypiques coulées à la main en France, sorties d’une plateforme qui les bridait.](https://www.lyvora.agency/candlelice)

## Tutoriels voisins

[Tous les tutoriels](https://www.lyvora.agency/blog/academie)

- [Sur le même sujet Shopify Horizon : personnaliser le thème, bloc par bloc](https://www.lyvora.agency/blog/academie/theme-horizon-shopify)
- [Académie · 4 novembre 2026 Hreflang sur Shopify : vérifier ce que Markets génère](https://www.lyvora.agency/blog/academie/hreflang-shopify)
- [Académie · 4 novembre 2026 Variantes Shopify : tailles, couleurs et matières](https://www.lyvora.agency/blog/academie/variantes-shopify)
