Avant de créer le moindre projet, il faut relier Shopify CLI à votre compte, et comprendre un principe qui va vous accompagner tout au long de ce parcours : chaque commande s'applique à un store précis, jamais à un endroit vague.

S'authentifier

La première fois qu'une commande Shopify CLI a besoin d'accéder à votre compte, elle ouvre automatiquement votre navigateur sur un écran de connexion Shopify. Ce parcours suit exactement le même schéma que celui déjà présenté dans le parcours Git & GitHub de Web-Shine Docs pour GitHub, ou dans le parcours MCP de Web-Shine Docs pour un service OAuth : vous vous connectez avec votre compte, vous confirmez l'accès demandé, puis vous revenez à votre terminal, désormais authentifié. Un jeton d'accès est alors conservé localement, pour éviter de répéter cette étape à chaque commande.

Le contexte : à quelle boutique une commande s'applique-t-elle

C'est le point le plus important de ce guide. Selon le type de projet (thème ou application), Shopify CLI détermine la boutique cible de différentes façons : parfois via une option explicite dans la commande, comme --store suivie de l'adresse de votre dev store, parfois via une configuration mémorisée au sein du projet lui-même, la première fois que vous liez ce projet à une boutique.

Par exemple, pour un projet de thème, vous préciserez généralement la boutique visée ainsi :

npx shopify theme dev --store votre-dev-store.myshopify.com

Remplacez toujours cette adresse d'exemple par celle de votre propre dev store, créé au guide 4. Une commande lancée avec la mauvaise adresse de boutique s'appliquerait à un store totalement différent, potentiellement une vraie boutique si vous en gérez plusieurs.

Vérifier le contexte avant d'agir

Une commande d'information, comme shopify theme info une fois dans un projet de thème, affiche la boutique actuellement configurée pour ce projet, sans rien modifier. Prenez l'habitude de la consulter avant une action importante, comme la publication d'un thème, exactement comme vous consultez git status avant un commit important dans le parcours Git & GitHub.

Une erreur de contexte peut affecter la mauvaise boutique

Si vous gérez à la fois un dev store et une vraie boutique marchande, comme Atelier Lumière, vérifiez systématiquement à quelle boutique une commande Shopify CLI va s'appliquer avant de l'exécuter, en particulier pour toute commande qui publie ou modifie quelque chose. C'est exactement le même réflexe de prudence que celui enseigné pour Git tout au long du parcours Git & GitHub de Web-Shine Docs.

Comment vérifier que la connexion fonctionne

Depuis un terminal, sans encore avoir créé de projet, une commande comme npx shopify auth logout puis une nouvelle commande qui nécessite une authentification vous permet de confirmer que le cycle de connexion se déclenche correctement, avec l'ouverture du navigateur, jusqu'au retour réussi dans le terminal.

Vérifiez que vous avez compris

Vous avez lancé une commande Shopify CLI sans préciser explicitement de boutique, et sans avoir déjà lié ce projet à un store particulier. Cette commande va-t-elle s'exécuter dans le vide, sans jamais cibler de boutique réelle ?

Non, mais elle ne devinera pas non plus à votre place sans vous demander confirmation. Selon la commande, Shopify CLI vous demandera généralement de choisir une boutique parmi celles accessibles à votre compte authentifié, ou refusera de continuer tant que ce choix n'est pas fait explicitement. C'est précisément ce mécanisme qui évite qu'une commande n'affecte accidentellement la mauvaise boutique.

Chapitre terminé