Votre dev store est prêt. Il est temps d'installer Shopify CLI, l'outil en ligne de commande officiel de Shopify, qui centralise la création, le développement local et la publication de thèmes comme d'applications.

Ce que Shopify CLI fait concrètement

Shopify CLI n'est pas un simple raccourci : c'est le point d'entrée unique pour la quasi-totalité des tâches de développement que vous allez pratiquer dans ce parcours. Il peut créer un nouveau projet de thème ou d'application à partir d'une base fonctionnelle, lancer un serveur de développement local qui reflète en temps réel vos modifications, et envoyer votre code vers votre dev store. Vous le retrouverez dans la quasi-totalité des guides suivants, sous des commandes différentes selon la tâche.

Vérifier les prérequis

Comme vu au guide 3, Shopify CLI nécessite une version de Node.js relativement récente. Vérifiez-la avant d'installer l'outil :

node --version

Au moment de la rédaction de ce guide, les versions Node.js compatibles sont la branche 18 à partir de la version 18.20, la branche 20 à partir de la version 20.10, ou la branche 22. Si votre version est plus ancienne, mettez à jour Node.js avant de continuer.

Installer Shopify CLI

Vous n'avez pas besoin d'une installation séparée : Shopify CLI s'installe automatiquement au moment où vous créez votre premier projet. Vous n'avez donc rien à faire d'autre ici que de vérifier que votre terminal peut télécharger et exécuter des paquets npm, ce que node --version a déjà confirmé indirectement.

Si vous préférez tout de même vérifier l'outil dès maintenant, sans encore créer de projet, une exécution ponctuelle via npx l'affiche :

npx shopify version

Cette commande télécharge temporairement Shopify CLI, affiche sa version, sans rien installer de permanent sur votre ordinateur : c'est la vraie première utilisation de l'outil que vous allez maintenant pratiquer, guide après guide.

Pas d'installation globale unique à retenir

Contrairement à d'autres outils en ligne de commande, Shopify CLI est généralement installé projet par projet, comme une dépendance normale du projet, plutôt qu'une seule fois de façon globale sur votre ordinateur. Chaque nouveau projet de thème ou d'application que vous créerez, dans les prochains guides, embarque sa propre version de l'outil.

Comment vérifier que tout fonctionne

Si npx shopify version affiche un numéro de version, sans message d'erreur, vous êtes prêt pour la suite de ce parcours. Le prochain guide vous fait vous authentifier auprès d'une vraie boutique, votre dev store créé au guide précédent.

Vérifiez que vous avez compris

Vous avez utilisé Shopify CLI sur un premier projet de thème, puis vous créez un second projet, cette fois pour une application, dans un dossier totalement différent. Devrez-vous réinstaller Shopify CLI pour ce second projet ?

Pas manuellement. Shopify CLI s'installe généralement comme dépendance de chaque nouveau projet créé via ses commandes de génération, que vous découvrirez dans les prochains guides. Vous n'avez pas besoin d'une installation globale unique à gérer vous-même au préalable.

Chapitre terminé