Installation et développement local — Documentation kingsbell

Documentation kingsbell

Page 2 sur 9

Kingsbell utilise Shopify CLI pour le développement, la validation, la prévisualisation distante et le packaging. Travaillez sur une boutique de développement dédiée, jamais directement sur une boutique active.

Installation

bash

node --version
npm install --global @shopify/cli @shopify/theme
shopify version
git clone https://github.com/rokadhq/kingsbell.git
cd kingsbell

Node.js 20 ou ultérieur est requis.

Connexion à la boutique

bash

npm run dev -- --store votre-boutique.myshopify.com

Shopify CLI demandera l’authentification et créera ou réutilisera un thème de développement. Séparez développement, staging et production.

shopify.theme.toml.example contient uniquement des exemples. Ne validez jamais mots de passe, jetons, cookies, données client ou secrets d’application.

Commandes

bash

npm run dev -- --store votre-boutique.myshopify.com
npm run check
npm run package

dev lance la prévisualisation et synchronise les changements.
check exécute Theme Check.
package génère une archive Shopify installable.

Méthode de travail

Créez une branche par changement.
Lancez Theme Check avant et après modification.
Testez la section dans l’éditeur de thème.
Enregistrez puis rechargez le modèle.
Vérifiez bureau, mobile et clavier seul.
Testez états vides, erreurs, rupture de stock, promotions et nombreux variants.

Frontière d’exécution

text

assets/
blocks/
config/
layout/
locales/
sections/
snippets/
templates/

.design, les documents QA, les scripts et les contrats compagnons ne font pas partie du thème exécuté. .shopifyignore les exclut des opérations Shopify CLI.

Sections et modèles

Toute nouvelle section doit fournir un schéma JSON valide, des valeurs par défaut utilisables, des routes et formulaires Shopify, un ordre sémantique correct, un focus visible et la prise en charge du mouvement réduit.

Tout modèle JSON doit référencer des types de section existants, définir l’ordre, éviter les conteneurs vides et pouvoir être ouvert puis enregistré dans l’éditeur.

Assets et JavaScript

Utilisez les images et vidéos hébergées par Shopify, avec texte alternatif, tailles responsives et recadrage vérifié.

Le JavaScript doit être progressif, différé si possible et compatible avec les rechargements de sections. Évitez les écouteurs dupliqués et conservez un état fonctionnel sans JavaScript.

Validation et packaging

bash

npm run check
npm run package

Le workflow Phase 8 génère Kingsbell-0.8.0.zip. Installez exactement cette archive dans une boutique propre avant approbation.

Un package valide ne prouve pas que les parcours commerciaux, comptes, B2B, performances ou l’accessibilité sont corrects.