La plupart des thèmes Shopify sur mesure commencent par une copie de Dawn. Il est gratuit, rapide et maintenu par Shopify. Pour Leafwise, un thème pour pépinières et boutiques de plantes que nous vendons sur notre propre boutique, ce point de départ n’était pas possible.
Voici comment nous avons écrit un thème Shopify de zéro : pourquoi nous n’avons pas forké Dawn, comment le thème est organisé et les problèmes d’outillage rencontrés jusqu’à un Theme Check propre.
À propos de cet article : Leafwise est notre propre produit, tout vient donc du vrai projet. Les exemples de code sont raccourcis, pas inventés.

Pourquoi ne pas forker Dawn ?
La licence de Dawn permet de construire dessus, mais les thèmes dérivés de Dawn ne peuvent être distribués que via le Shopify Theme Store. Nous voulions vendre Leafwise directement, avec notre prix et notre licence. Cela voulait dire aucune ligne de Dawn : ni la structure des sections, ni le JavaScript, ni le CSS.
Partir d’un dossier vide avait aussi un avantage. Chaque section existe parce qu’une boutique de plantes en a besoin, et il ne reste rien d’une boutique de mode.
L’architecture en un paragraphe
Leafwise est un thème Online Store 2.0 simple : modèles JSON, un groupe d’en-tête et un groupe de pied de page, et des sections avec des blocs partout. Sept palettes de couleurs vivent dans un seul groupe, et un snippet transforme chacune en classe CSS avec des propriétés personnalisées, si bien que chaque section change de palette avec un seul réglage. Pas de framework, pas d’étape de build. Les parties interactives sont de petits custom elements dans quatre fichiers différés.
side-draweretcart-drawerpour le menu, la recherche et le panierproduct-form,variant-picker,media-galleryetsticky-atcsur les pages produitfacets-areapour les filtres sans rechargement,predictive-searchpour les suggestionsplant-quizetfilter-tabssur l’accueil
Le panier : une requête, toutes les sections à jour
L’ajout au panier doit mettre à jour en même temps le panneau, le compteur de l’en-tête et la navigation mobile. La Section Rendering API le fait dans la même requête : nous demandons à Shopify de rendre les sections nécessaires et nous remplaçons leur HTML.
formData.append('sections', 'cart-drawer,cart-count');
formData.append('sections_url', window.location.pathname);
const res = await fetch('/cart/add.js', { method: 'POST', body: formData });
const data = await res.json();
// data.sections['cart-drawer'] is fresh HTML for the drawer
Chaque élément qui affiche des données du panier porte l’attribut data-cart-section : un nouvel endroit qui affiche le panier n’a besoin que de l’attribut, pas de nouveau JavaScript.
Theme Check affichait « 0 files inspected »
Sous Windows, shopify theme check s’exécutait sans erreur et annonçait zéro fichier inspecté, quel que soit le dossier. Un résultat propre qui n’a rien vérifié est pire qu’une erreur. Nous avons appelé le même vérificateur directement via son paquet Node :
const { themeCheckRun } = require('@shopify/theme-check-node');
const { offenses, theme } = await themeCheckRun(root, undefined, console.error);
console.log('Files inspected:', theme.length);
Il a trouvé une erreur et quatre avertissements, dont un nom de section trop long. Après correction : 90 fichiers, 0 erreur, 0 avertissement.
Le zip que Shopify pourrait refuser
Compress-Archive de PowerShell écrivait le zip avec des barres obliques inversées, soit sections\header.liquid au lieu de sections/header.liquid. Certains outils de décompression et d’import ne l’acceptent pas. Nous créons le zip avec ZipArchive de .NET et écrivons nous-mêmes chaque chemin avec des barres obliques.
$rel = $file.FullName.Substring($src.Length + 1).Replace('\', '/')
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($zip, $file.FullName, $rel)
Ce que nous referions de la même façon
- Pas de framework : quatre petits fichiers se chargent plus vite qu’un bundle et se lisent facilement
- La Section Rendering API pour tout ce que touche le panier
- Lancer Theme Check via le paquet Node en CI et faire échouer le build si aucun fichier n’a été inspecté
- Tester tôt sur une vraie boutique de développement. Theme Check était au vert, mais la boutique a encore trouvé huit bugs, sujet de notre prochain article
Leafwise est en vente sur Charming Theme. Si vous avez besoin d’un thème Shopify écrit de zéro pour votre boutique, découvrez notre service de développement de thèmes Shopify.
Questions fréquentes
Puis-je vendre un thème basé sur Dawn hors du Theme Store ?
La licence de Dawn n’autorise la distribution des thèmes dérivés que via le Shopify Theme Store. Pour vendre ailleurs, écrivez votre propre code.
Combien de temps de plus pour un thème de zéro par rapport à un fork de Dawn ?
Plus au début, car le panier, les filtres et la logique des variantes sont à écrire. En échange, chaque ligne vous appartient et aucun code inutile ne traîne.
Un thème Shopify moderne a-t-il besoin d’une étape de build ?
Non. Du CSS simple avec des propriétés personnalisées et de petits custom elements couvrent tout ce dont Leafwise a besoin.