Constructeur de Sites Web
Flux de Travail
1. Évaluer le Projet
Déterminez le type de projet et sélectionnez la pile :
| Signal | Pile | Déploiement |
|---|---|---|
| Site marketing, portfolio, pages simples | HTML/CSS/JS vanilla ou Astro | Netlify |
| Application dynamique avec auth, API, base de données | Next.js + Tailwind | Vercel |
| Pages de boutique Shopify (produit, collection, accueil) | Modèles Liquid + JSON | API Shopify |
| Blog/site riche en contenu | Astro + MDX | Netlify |
Pour des critères détaillés de sélection de pile, voir references/stack_guide.md.
2. Établir le Système de Design
Avant d'écrire un composant, définissez les jetons de design :
Couleurs : primaire, secondaire, accent, neutre (50-900), succès, erreur
Typographie : police de titre, police de corps, échelle (xs à 4xl)
Espacement : unité de base 4px (4, 8, 12, 16, 24, 32, 48, 64)
Rayon : sm (4px), md (8px), lg (12px), complet
Ombres : sm, md, lg
Appliquez les éléments de marque (logo, couleurs, polices) de manière cohérente sur tous les composants. Pour les motifs de construction de palette, voir references/design_tokens.md. Pour l'inspiration design bien-être/e-commerce (style Serene Herbs, Magic Mind), voir references/design_inspiration.md.
3. Construire les Composants
Sites statiques : Construisez section par section, mobile-first. Chaque section est autonome avec ses propres styles.
Applications React/Next.js : Architecture orientée composants. Construisez atomes → molécules → organismes → pages.
Thèmes Shopify : Construisez en tant que sections Liquid avec des blocs {% schema %} pour l'éditabilité via le Personnalisateur de Thème. Pour les motifs spécifiques à Shopify, les pièges et le déploiement, voir references/shopify_2_0.md.
4. Déployer
Netlify (sites statiques) :
npx netlify-cli deploy --prod --dir=./dist
Shopify (sections Liquid + modèles JSON) : Utilisez les scripts fournis pour pousser via l'API Admin :
scripts/deploy_shopify_section.py— pousser les fichiers de section.liquidscripts/deploy_shopify_template.py— pousser le modèle JSON + assigner les produits
Vercel (Next.js) :
npx vercel --prod
Pour les détails de déploiement et les motifs de sécurité, voir references/deployment.md.
Référence Rapide Shopify
Shopify est la pile la plus sujette aux erreurs. Pièges clés :
- Types de blocs — Utilisez les noms réels des types de blocs du thème (par ex.
titlepas@app/title) - Champs Richtext — Pas d'attributs
stylesur les balises HTML ; seulement du HTML sémantique - Schémas de couleurs — Nommés
scheme-1àscheme-5(pasbackground-1) - image-with-text — Le contenu utilise des blocs (heading, text, button), PAS des paramètres au niveau de la section
- Sécurité de template_suffix — Changer le suffixe affecte TOUS les thèmes ; poussez toujours un modèle de repli vers le thème actif en premier
- Limitation de débit — Ajoutez
time.sleep(0.5)entre les appels API
Référence Shopify complète avec exemples : references/shopify_2_0.md