Constructeur de sites web Astro
Cette compétence vous aide à créer des sites web avec Astro.build en vous guidant dans la sélection des thèmes, l'accès à la documentation, et les bonnes pratiques de développement. Utilisez cette compétence dès qu'un utilisateur mentionne la création avec Astro, souhaite créer un site web, ou a besoin d'aide avec des fonctionnalités spécifiques à Astro.
Quand utiliser cette compétence
Activez cette compétence lorsque :
- L'utilisateur mentionne "Astro" ou "astro.build" dans sa demande
- L'utilisateur souhaite créer un site web et Astro est approprié (blogs, documentation, portfolios, sites marketing, etc.)
- L'utilisateur doit sélectionner un thème pour son projet Astro
- L'utilisateur a besoin d'aide avec les composants, le routage ou la configuration d'Astro
- L'utilisateur veut intégrer React, Vue ou d'autres frameworks avec Astro
- L'utilisateur a besoin d'accéder à la documentation d'Astro ou aux bonnes pratiques
Aperçu du workflow
Lors de la création d'un site web Astro, suivez ce processus :
- Comprendre les besoins - Déterminer le type de site web et les fonctionnalités nécessaires
- Sélectionner le thème approprié - Choisir parmi les thèmes gratuits d'Astro en fonction des exigences
- Accéder à la documentation - Consulter la documentation Astro pour les fonctionnalités spécifiques
- Initialiser le projet - Mettre en place la structure du projet
- Développer les composants - Construire en utilisant l'architecture des composants Astro
- Optimiser et déployer - Suivre les bonnes pratiques de performance
Étape 1 : Comprendre les besoins
Tout d'abord, identifiez le type de site web et ses exigences :
Types de sites web :
- Blog / Site de publication
- Portfolio / Vitrine
- Site de documentation
- Page d'atterrissage / Marketing
- Site e-commerce
- Site d'entreprise / professionnel
- Site personnel
Questions clés à poser :
- Quel est l'objectif principal du site ?
- Quels types de contenu aura-t-il ? (articles de blog, projets, produits, etc.)
- A-t-il besoin d'interactivité ? (formulaires, recherche, contenu dynamique)
- Quels frameworks l'utilisateur préfère-t-il ? (React, Vue, Svelte, etc.)
- A-t-il besoin de fonctionnalités spécifiques ? (mode sombre, i18n, intégration CMS)
Étape 2 : Sélectionner le thème approprié
Utilisez web_fetch pour parcourir les thèmes gratuits compatibles React :
URL : https://astro.build/themes/1/?search=&technology%5B%5D=react&price%5B%5D=free
Critères de sélection du thème :
Pour les blogs / publications :
- Rechercher des thèmes avec une typographie soignée
- Doit prendre en charge Markdown/MDX
- Doit avoir des étiquettes/catégories
- Prise en charge des flux RSS
- Considérer : astro-paper, astro-blog-template
Pour les portfolios :
- Présentation visuelle des projets
- Sections À propos / Contact
- Animations fluides
- Considérer : astro-portfolio, thèmes personnal-portfolio
Pour la documentation :
- Utiliser Starlight (framework officiel de documentation Astro)
- Fonctionnalités : Recherche, navigation latérale, mode sombre, i18n
- Idéal pour : Documentation technique, références API, guides
Pour les pages d'atterrissage :
- Section héros avec appel à l'action (CTA)
- Sections Fonctionnalités / Avantages
- Formulaires de contact
- Optimisé pour la conversion
Pour l'e-commerce :
- Listes de produits et filtres
- Fonctionnalité de panier d'achat
- Prêt pour l'intégration de paiement
- Pages de détail produit
Action : Récupérez la page des thèmes, analysez les thèmes disponibles, et recommandez 2 à 3 options qui correspondent le mieux aux besoins de l'utilisateur. Expliquez pourquoi chaque thème est approprié.
Étape 3 : Accéder à la documentation d'Astro
Lorsque vous avez besoin d'une documentation spécifique à Astro, référencez :
- Référence intégrée :
references/astro_docs.md- Contient les concepts fondamentaux d'Astro, la syntaxe et les patterns courants - Documentation complète : Récupérez depuis
https://docs.astro.build/llms-full.txtpour des informations exhaustives
Quand consulter la documentation :
- Questions sur la syntaxe des composants → Consultez astro_docs.md
- Routage et pages → Consultez astro_docs.md
- Options de style → Consultez astro_docs.md
- Fonctionnalités avancées → Récupérez depuis docs.astro.build
- Configuration d'intégration → Récupérez depuis docs.astro.build
- Détails de l'API → Récupérez depuis docs.astro.build
Étape 4 : Initialiser un projet Astro
Utilisation de l'interface en ligne de commande Create Astro
# Créer un nouveau projet
npm create astro@latest
# Ou avec un modèle spécifique
npm create astro@latest -- --template <nom-utilisateur-theme-github>/<depot-theme>
Configuration de la structure du projet
Après l'initialisation, assurez-vous d'une structure correcte :
projet/
├── src/
│ ├── components/ # Composants réutilisables
│ ├── layouts/ # Mises en page
│ ├── pages/ # Routes (OBLIGATOIRE)
│ │ └── index.astro # Page d'accueil
│ ├── content/ # Collections de contenu (optionnel)
│ └── assets/ # Images optimisées
├── public/ # Ressources statiques
├── astro.config.mjs # Configuration
├── package.json
└── tsconfig.json
Critique : Le répertoire src/pages/ est OBLIGATOIRE pour le bon fonctionnement du routage.
Étape 5 : Développer des composants et des pages
Modèle de développement de composants
- Créer le fichier du composant dans
src/components/ - Définir l'interface des props (si TypeScript est utilisé)
- Écrire le script du composant (s'exécute au moment de la construction)
- Créer le template (HTML avec syntaxe Astro)
- Ajouter des styles limités (optionnel)
Exemple :
---
interface Props {
title : chaîne de caractères ;
description? : chaîne de caractères ;
}
const { title, description } = Astro.props ;
---
<article>
<h2>{title}</h2>
{description && <p>{description}</p>}
</article>
<style>
article {
padding : 1rem ;
border : 1px solid #ccc ;
}
</style>
Modèle de développement de pages
- Créer le fichier de la page dans
src/pages/(détermine la route) - Importer les composants et les mises en page nécessaires
- Définir
getStaticPaths()pour les routes dynamiques - Composer la page à l'aide des composants
Exemple de page :
---
import Layout from '../layouts/Layout.astro' ;
import Hero from '../components/Hero.astro' ;
const title = "Ma page" ;
---
<Layout title={title}>
<Hero />
<!-- Plus de contenu -->
</Layout>
Ajout d'interactivité
Lorsque vous avez besoin d'interactivité côté client :
- Installer l'intégration du framework :
npx astro add react - Créer un composant du framework (.jsx, .vue, .svelte)
- Importer et utiliser avec une directive client :
---
import ReactComponent from '../components/ReactComponent.jsx' ;
---
<!-- Statique (pas de JS) -->
<ReactComponent />
<!-- Interactif -->
<ReactComponent client:load />
<!-- Options : client:idle, client:visible, client:media -->
Étape 6 : Consulter la documentation selon les besoins
Avant d'écrire du code, lisez les sections pertinentes de references/astro_docs.md :
- Questions sur les composants → Lire la section "Syntaxe des composants"
- Problèmes de routage → Lire la section "Routage"
- Style → Lire la section "Style"
- Images → Lire la section "Images et ressources"
- Configuration → Lire la section "Configuration"
Pour les sujets avancés, récupérez la documentation complète :
web_fetch : https://docs.astro.build/llms-full.txt
Bonnes pratiques
Optimisation des performances
- Garder les composants statiques par défaut - N'ajouter
client:*que lorsque c'est réellement nécessaire - Utiliser le composant Image d'Astro - Optimisation automatique
- Tirer parti de l'architecture d'îles - JavaScript minimal par défaut
- Division du code - Astro divise automatiquement par page
Workflow de développement
- Commencer par la structure - Mettre en place les mises en page et les pages de base en premier
- Orienté composants - Construire des composants réutilisables
- Sécurité des types - Utiliser TypeScript pour les props et une meilleure expérience développeur
- Collections de contenu - Pour une gestion de contenu type-safe
- Tester localement - Exécuter
npm run devfréquemment
Modèles courants à suivre
- Utiliser des mises en page pour une structure de page cohérente
- Créer un composant SEO pour les balises meta
- Mettre en place des interfaces TypeScript appropriées
- Implémenter des pages d'erreur correctes (404, 500)
- Ajouter un texte alternatif approprié aux images
- Utiliser un HTML sémantique
Dépannage
Problèmes courants
"Module introuvable"
- Vérifier les chemins d'importation corrects
- Vérifier que les intégrations sont installées
- Vérifier que
astro.config.mjsa une configuration d'intégration correcte
"La page ne s'affiche pas"
- Vérifier que le fichier se trouve dans le répertoire
src/pages/ - Vérifier les erreurs de syntaxe dans le frontmatter
- Vérifier que l'extension de fichier est correcte (.astro, .md, .mdx)
"Les styles ne s'appliquent pas"
- Les styles limités ne s'appliquent qu'au propre HTML du composant
- Utiliser
is:globalpour les styles globaux - Vérifier la configuration Tailwind si vous utilisez Tailwind
"Le composant n'est pas interactif"
- Ajouter une directive
client:*aux composants du framework - Vérifier que l'intégration est installée (par exemple
@astrojs/react) - Vérifier la console du navigateur pour les erreurs JavaScript
Ressources
Scripts
scripts/theme_analyzer.py- Aide à récupérer et analyser les thèmes Astro depuis la page officielle des thèmes. Utilisez-le pour explorer programmatiquement les options de thème en fonction des filtres de technologie et de prix.
Références
references/astro_docs.md- LISEZ CECI EN PREMIER pour les concepts fondamentaux d'Astro, la syntaxe des composants, le routage, le style et les modèles courants. Il s'agit de votre référence principale pour le développement Astro.
Ressources externes
- Thèmes Astro : https://astro.build/themes/
- Documentation Astro (adaptée au LLM) : https://docs.astro.build/llms-full.txt
- Documentation Astro : https://docs.astro.build
- Discord Astro : https://astro.build/chat
Exemples de workflows
Exemple 1 : Construire un blog
Utilisateur : "Je veux construire un blog avec Astro et React"
Workflow :
- Identifier les besoins : Site blog, nécessite le support React, veut un thème gratuit
- Récupérer les thèmes :
web_fetch https://astro.build/themes/1/?technology%5B%5D=react&price%5B%5D=free - Recommander un thème : Suggérer 2-3 thèmes orientés blog avec explications
- Lire
references/astro_docs.mdpour consulter les modèles de composants - Guider la configuration : Fournir les commandes d'installation et la structure
- Aider à la construction : Créer la mise en page des articles de blog, page de liste, pages d'articles individuels
- Ajouter de l'interactivité : Montrer comment ajouter des composants React avec
client:loadpour des fonctionnalités comme les commentaires
Exemple 2 : Site portfolio
Utilisateur : "Créez un site portfolio pour moi en utilisant https://astro.build/"
Workflow :
- Clarifier les besoins : Quoi exposer (projets, compétences, expérience ?)
- Récupérer les thèmes portfolio depuis la page des thèmes Astro
- Recommander la meilleure correspondance en fonction du domaine de l'utilisateur (développeur, designer, etc.)
- Lire la syntaxe des composants depuis
references/astro_docs.md - Mettre en place la structure du projet avec le thème sélectionné
- Créer/personnaliser les composants (Hero, grille Projets, À propos, Contact)
- Ajouter des transitions fluides si nécessaire
- Optimiser les images à l'aide du composant Image d'Astro
Exemple 3 : Site de documentation
Utilisateur : "J'ai besoin d'un site de documentation avec recherche et mode sombre"
Workflow :
- Identifier : Site de documentation, nécessite recherche et mode sombre
- Recommander Starlight (framework officiel de documentation Astro)
- Montrer la configuration :
npm create astro@latest -- --template starlight - Consulter la documentation Starlight depuis la documentation complète d'Astro
- Configurer la structure de navigation latérale
- Mettre en place la structure du contenu
- Activer le mode sombre (intégré)
- Configurer la recherche (intégrée avec Pagefind)
Rappels importants
- Lisez toujours
references/astro_docs.mdEN PREMIER avant de répondre à des questions sur les composants ou la syntaxe - Récupérez les thèmes depuis la page des thèmes Astro lorsque l'utilisateur a besoin d'un point de départ
- Utilisez
web_fetchpour la documentation complète si nécessaire - Gardez les choses simples - Astro est conçu pour être simple ; ne compliquez pas trop
- Architecture d'îles - Rappelez-vous que les composants sont statiques par défaut
- Sécurité des types - Encouragez l'utilisation de TypeScript pour une meilleure expérience de développement
Critères de succès
Un projet Astro est correctement configuré lorsque :
- ✅ La structure du projet suit les conventions Astro
- ✅ Le répertoire
src/pages/existe avec au moins index.astro - ✅ Un thème approprié a été sélectionné en fonction des besoins
- ✅ Les composants respectent les modèles de syntaxe Astro
- ✅ L'interactivité côté client n'est ajoutée que là où c'est nécessaire
- ✅ Les interfaces TypeScript sont définies pour les props des composants
- ✅ Les images sont optimisées à l'aide du composant Image d'Astro
- ✅ Le site s'exécute correctement avec
npm run dev