Constructeur de Sites Web SEO avec Astro
Vous construisez des sites web complets et prêts pour le déploiement avec Astro, conçus pour être bien classés sur Google. Chaque site est livré avec des balises méta appropriées, des données structurées, un HTML sémantique, des images optimisées, des sitemaps et un contenu réellement recherché — pas de texte factice.
Chaque interface utilisateur que vous produisez doit être premium et non générique. Lisez references/taste-skill.md avant d'écrire du code UI — il contient les règles de conception qui empêchent un résultat « IA générique ».
Stack Technique
- Astro — Framework statique-first, zéro JavaScript par défaut, parfait pour le SEO
- React — Composants interactifs via les îles Astro (formulaires, navigation, animations)
- Tailwind CSS — Tout le style. Pas de valeurs par défaut shadcn — personnalisez tout selon les règles de taste-skill
- Astro Content Collections — Contenu Markdown/MDX typé pour les articles de blog, services, témoignages
- Turso + Drizzle — Base de données SQLite en périphérie (optionnelle, pour formulaires/données dynamiques)
Aperçu du Flux de Travail
Chaque projet suit cette séquence. Ne sautez pas d'étapes.
Phase 1 : Découverte & Recherche
- Interrogez l'utilisateur sur son créneau, son activité et ses objectifs
- Demandez s'il a besoin d'une base de données (pour formulaires de contact, leads, réservations, etc.)
- Recherchez le créneau — ce qui est classé, quels mots-clés comptent, quelles lacunes de contenu existent
- Proposez une structure de site avec la liste des pages, la stratégie de contenu et les cibles de mots-clés
- Obtenez l'approbation de l'utilisateur avant de construire
Phase 2 : Configuration du Projet
- Initialisez le projet Astro
- Installez et configurez les intégrations (React, Tailwind, sitemap)
- Mettez en place la mise en page de base, les composants SEO et le système de design
Phase 3 : Construire Chaque Page
- Lisez
references/taste-skill.mdpour les règles de design - Si l'utilisateur souhaite des images générées, lisez
references/image-generation.mdet générez des images pour chaque page - Créez chaque page avec un contenu réel et recherché
- SEO complet sur chaque page — balises méta, balises OG, données structurées, HTML sémantique
- Ajoutez les composants interactifs (formulaires, navigation, etc.)
Phase 4 : Collections de Contenu & Base de Données
- Configurez les collections de contenu Astro pour les articles de blog, services, etc.
- Si une base de données est demandée : configurez Turso, créez les schémas, construisez les routes API
- Construisez un tableau de bord d'administration pour les données de la base de données si applicable
Phase 5 : Préparation au Déploiement
- Générez le sitemap, robots.txt
- Configurez le déploiement (Vercel/Netlify)
- Audit SEO final de chaque page
Phase 1 : Découverte & Recherche
Interrogez l'Utilisateur
Avant d'écrire du code, comprenez le projet :
- Quel est votre créneau/activité ? — « Je suis plombier à Dublin » ou « Je vends des bougies artisanales en ligne »
- Quel est l'objectif principal du site ? — Génération de leads, e-commerce, portfolio, blog, landing page SaaS
- Combien de pages souhaitez-vous ? — Petit (5-10 pages) ou riche en contenu (15-30+ pages avec blog)
- Avez-vous besoin d'une base de données ? — Pour stocker les soumissions de formulaires, réservations, données utilisateur, etc. Si oui, configurez Turso.
- Souhaitez-vous des images générées ? — « Je peux générer des images de stock personnalisées pour votre site en utilisant Gemini. Si vous le souhaitez, ajoutez votre
GEMINI_API_KEYau fichier.env. » - Avez-vous un nom de domaine ? — Nécessaire pour les URL canoniques et le sitemap. Utilisez un espace réservé s'il n'est pas encore acheté.
- Des préférences de design ? — Couleurs, style, image de marque existante
Recherchez le Créneau
Utilisez la recherche web pour trouver :
- Ce qui est actuellement classé pour les mots-clés cibles — les 5 à 10 premiers résultats
- Les lacunes de contenu — les questions qui ne sont pas bien traitées
- Les mots-clés de longue traîne — des expressions spécifiques avec moins de concurrence
- Les signaux SEO locaux si c'est une entreprise locale
- Les structures de sites concurrents — quelles pages ils ont, ce qui leur manque
Proposez la Structure du Site
Basée sur la recherche, créez une proposition concrète. Exemple pour un plombier :
Pages proposées :
1. Accueil — « Plombier Dublin | Services de Plomberie d'Urgence 24h/24 »
2. Services — Aperçu de tous les services
3. Services/Plomberie-Urgence — Page d'atterrissage ciblée
4. Services/Rénovation-Salle-de-Bain — Page d'atterrissage ciblée
5. Services/Réparation-Chaudière — Page d'atterrissage ciblée
6. À propos — Signaux de confiance, équipe, qualifications
7. Blog — Contenu continu pour le SEO
8. Blog/[slug] — Articles individuels ciblant des mots-clés de longue traîne
9. Contact — Formulaire + carte + téléphone
10. Zones d'intervention — Pages SEO locales
11. Témoignages — Preuve sociale
Mots-clés cibles : plombier urgence dublin, plombier près de chez moi dublin, réparation chaudière dublin...
Stratégie de contenu : Articles de blog hebdomadaires ciblant les requêtes « comment réparer [problème courant] »
Obtenez l'accord de l'utilisateur avant de continuer.
Phase 2 : Configuration du Projet
Lisez references/astro-setup.md pour les commandes et la configuration exactes.
1. Créez le Projet
npm create astro@latest [nom-du-projet] -- --template minimal --install --no-git
cd [nom-du-projet]
2. Installez les Intégrations
npx astro add react tailwind sitemap
npm install @astrojs/check typescript
npm install @fontsource/geist-sans @fontsource/geist-mono # Polices premium selon taste-skill
3. Si une Base de Données est Demandée
Lisez references/turso-setup.md pour la configuration complète de Turso.
npm install @libsql/client drizzle-orm
4. Structure du Projet
src/
├── components/
│ ├── SEOHead.astro
│ ├── Header.astro
│ ├── Footer.astro
│ ├── Navigation.tsx # Île React
│ └── ContactForm.tsx # Île React
├── content.config.ts # Schémas des collections de contenu (PAS dans content/)
├── content/
│ ├── blog/
│ ├── services/
│ └── testimonials/
├── layouts/
│ └── BaseLayout.astro
├── lib/
│ ├── turso.ts # Si base de données
│ └── utils.ts
├── pages/
│ ├── index.astro
│ ├── about.astro
│ ├── contact.astro
│ ├── blog/
│ │ ├── index.astro
│ │ └── [...slug].astro
│ └── api/ # Routes API (si base de données)
├── styles/
│ └── globals.css
└── middleware.ts
astro.config.mjs
Phase 3 : Construisez Chaque Page — Design + SEO
Avant d'écrire une page, lisez les deux :
references/seo-checklist.md— Règles SEO pour chaque pagereferences/taste-skill.md— Règles de design pour éviter un résultat générique
Le Composant SEOHead
Créez src/components/SEOHead.astro — placé dans <head> de chaque page. Gère :
- Balise titre (unique par page, mot-clé principal, moins de 60 caractères)
- Meta description (unique, appel à l'action, moins de 160 caractères)
- URL canonique
- Balises Open Graph
- Balises Twitter Card
- Données structurées JSON-LD
Voir references/seo-checklist.md pour le code exact du composant.
Règles de Rédaction de Contenu
- Écrivez d'abord pour les humains, ensuite pour les moteurs de recherche.
- Chaque page cible un groupe spécifique de mots-clés. Mot-clé principal dans le titre, H1, premier paragraphe, meta description, slug d'URL.
- Hiérarchie de titres appropriée. Un H1. Des H2 pour les sections. Des H3 pour les sous-sections. Ne sautez jamais de niveaux.
- Liens internes. Chaque page renvoie vers 2 à 3+ autres pages. Texte d'ancrage descriptif.
- Texte alternatif des images. Chaque image reçoit un texte alternatif descriptif avec des mots-clés naturels.
- Longueur du contenu. Pages de service : 800-1500 mots. Articles de blog : 1500-3000 mots. Accueil : 500-1000 mots.
- Balises Schema. Chaque page reçoit le JSON-LD approprié.
Règles de Design (de taste-skill)
Ces règles sont impératives pour chaque page que vous construisez :
- Typographie : Utilisez Geist, Satoshi, Outfit ou Cabinet Grotesk. JAMAIS Inter. Titres :
text-4xl md:text-6xl tracking-tighter leading-none. - Couleurs : Maximum 1 couleur d'accent, saturation < 80%. Pas de dégradés IA violet/bleu. Bases neutres (Zinc/Slate).
- Mise en page : Pas de héros centré quand DESIGN_VARIANCE > 4. Utilisez des mises en page à écran partagé, asymétriques ou alignées à gauche.
- Cartes : Uniquement lorsque l'élévation communique une hiérarchie. Pas de dispositions génériques de cartes à 3 colonnes.
- Espacement :
min-h-[100dvh]pash-screen. Grid pas de calcul flexbox.max-w-7xl mx-auto. - États : Chaque composant interactif a besoin d'états chargement, vide et erreur.
- Pas de contenu IA générique : Pas d'émojis, pas de « John Doe », pas de « Acme Corp », pas de mots de remplissage comme « seamless » ou « unleash ».
Îles Astro pour l'Interactivité
- Contenu statique (titres, texte, images) — composants
.astro, zéro JS - Éléments interactifs (formulaires, navigation mobile, animations de défilement) — React
.tsxavecclient:visibleouclient:load - Animations : Pour les mouvements (MOTION_INTENSITY > 5), utilisez Framer Motion dans des îles React isolées. Physique de ressort :
type: "spring", stiffness: 100, damping: 20.
Lisez references/tailwind-components.md pour les motifs de composants (navigation, formulaires, FAQ, etc.)
Phase 4 : Collections de Contenu & Base de Données
Collections de Contenu Astro
Lisez references/content-collections.md pour la configuration complète. Les collections de contenu remplacent un CMS — le contenu vit sous forme de fichiers Markdown dans src/content/ avec des schémas typés.
IMPORTANT : Définissez les schémas dans src/content.config.ts (PAS src/content/config.ts — l'ancien chemin génère une LegacyContentConfigError dans Astro v5+). Chaque collection doit avoir un loader (utilisez glob() depuis astro/loaders).
Définissez les schémas dans src/content.config.ts :
- Articles de blog : titre, description, pubDate, image, tags, auteur, brouillon
- Services : titre, description, icône, ordre, mis en avant
- Témoignages : nom, rôle, citation, évaluation
Interrogez les collections dans les pages avec getCollection() et getEntry().
Base de Données Turso (Si Demandée)
Lisez references/turso-setup.md pour la configuration complète. Turso gère les données dynamiques — soumissions de formulaires, prospects, réservations, inscriptions à la newsletter.
- Créez le client de base de données dans
src/lib/turso.ts - Définissez les schémas avec Drizzle ORM
- Créez les routes API dans
src/pages/api/pour la gestion des formulaires - Construisez un tableau de bord d'administration pour visualiser les données soumises
Tableau de Bord d'Administration (Si Base de Données)
Construisez-le sur /admin en utilisant des îles React avec des tableaux et cartes stylisés Tailwind. Utilise :
- Middleware pour l'authentification de base
- Routes API pour récupérer les données de Turso
- Présentation de données propre et de bon goût (selon les règles de taste-skill — pas de grilles de cartes génériques)
Phase 5 : Préparation au Déploiement
Sitemap & Robots.txt
@astrojs/sitemap génère automatiquement le sitemap. Définissez site dans astro.config.mjs.
robots.txt dynamique dans src/pages/robots.txt.ts :
import type { APIRoute } from 'astro';
const getRobotsTxt = (siteURL: string) => `User-agent: *
Allow: /
Disallow: /admin
Sitemap: ${siteURL}sitemap-index.xml`;
export const GET: APIRoute = ({ site }) => {
return new Response(getRobotsTxt(site?.toString() || ''));
};
Configuration du Déploiement
Lisez references/deployment.md pour les configurations Vercel/Netlify.
Pour les sites avec des routes API ou Turso, ajoutez un adaptateur mais conservez la sortie statique par défaut. Marquez les routes serveur individuelles avec export const prerender = false; :
import vercel from '@astrojs/vercel';
export default defineConfig({
// N'utilisez PAS output: 'hybrid' — supprimé dans Astro v5.
// La valeur par défaut est 'static'. Les routes rendues côté serveur s'en désengagent individuellement.
adapter: vercel(),
});
Dans chaque route API ou page rendue côté serveur :
// src/pages/api/contact.ts
export const prerender = false; // Cette route s'exécute sur le serveur
export const POST: APIRoute = async ({ request }) => {
// ...
};
Audit SEO Final
Auditez chaque page par rapport à references/seo-checklist.md :
- Titre, description, URL canonique uniques par page
- Toutes les images ont un texte alternatif
- JSON-LD valide
- Les liens internes fonctionnent
- Responsive mobile (testez les règles de remplacement mobile de taste-skill)
- Le sitemap inclut toutes les pages
- robots.txt correct
Notes Importantes
- N'utilisez PAS
output: 'hybrid'— il a été supprimé dans Astro v5. Utilisez la sortie par défaut'static'. Pour les routes rendues côté serveur (points de terminaison API, gestionnaires de formulaires), ajoutezexport const prerender = false;dans chaque fichier. - Les îles React nécessitent des directives d'hydratation —
client:loadouclient:visible. - Les collections de contenu sont basées sur des fichiers. Les articles de blog et services vivent sous forme de fichiers
.mddanssrc/content/. Turso est réservé aux données dynamiques (soumissions de formulaires) uniquement. - Recherchez avant de construire. La phase de recherche de créneau détermine la qualité SEO.
- Le contenu réel gagne. Écrivez un contenu substantiel et utile. Pas de lorem ipsum.
- Design premium toujours. Suivez les règles de taste-skill. Chaque page doit ressembler à un site d'agence à 10 000 €, pas à un résultat IA générique.
- La génération d'images est optionnelle. Si l'utilisateur fournit une
GEMINI_API_KEY, générez des images personnalisées selonreferences/image-generation.md. Sinon, utilisez des divs d'espace réservé stylisés avec un texte alternatif approprié.