Si vous n'avez pas utilisé la commande create stardrive, retirez d'abord les fichiers de démo et de dépôt. Le guide de nettoyage (trimming) est écrit pour les agents IA, mais fonctionne aussi en manuel.

Ajustez les bases pour reconnaître le projet plus tard :

• Mettez à jour le package.json pour refléter votre projet.
• Renseignez au moins le titre dans le README.md.

Remplacez les fichiers d'icônes dans ./public/ (nous aimons realfavicongenerator.net). Le manifeste web est généré depuis theme.config.ts, vous ne remplacez donc que des images. Remplacez aussi les images sociales de secours og.png, x.png etstructured-preview.png dans ./public/images/.

C'est le cœur de la configuration. Tout est typé, votre IDE affiche donc la documentation en ligne. Procédez dans cet ordre :

• Renseignez les infos de base (URL du site, couleur primaire, …).
• Choisissez vos langues, ajoutez un fichier JSON par langue dans ./src/i18n/ et câblez le bloc i18n.
• Choisissez vos expressiveCodeThemes - un pour le mode clair, un pour le mode sombre.
• Configurez les valeurs par défaut du blog (et remplacez l'image de secours si vous l'utilisez).
• Activez ou désactivez les emplacements promotionnels.
• Définissez comment llms.txt est généré.

Stardrive fournit Geist via Fontsource. Remplacez-la par la vôtre (npm un @fontsource/geist, puis installez la vôtre). Ajustez les déclarations d'importation dans les fichiers de layout. Ensuite, ajustez./src/styles/tailwind.config.css :

• Mettez à jour la section des polices.
• Ajustez les couleurs de marque (changez les codes hex ; ne supprimez des lignes qu'une fois le contenu de démo retiré).
• Retouchez les breakpoints si vous le souhaitez.

Étendez les fichiers CSS de ./src/styles/ selon la convention de couches :

• Tailwind comme base.
• global.css pour les règles personnalisées et les styles à source unique de vérité (p. ex. les boutons).
• Des fichiers CSS spécifiques à une page (p. ex. long-text-content.css), importés par page.
• Les styles très personnalisés restent limités à la page ou au composant.

Supprimez les sous-dossiers dans ./src/content/ et ./src/pages/ pour les langues que vous ne prenez pas en charge. Une seule langue ? Vous pouvez aussi supprimer ./src/pages/[lang] ainsi que les composants du sélecteur de langue.

Façonnez votre structure sous ./src/pages/ (un fichier par route). Les pages qui ne diffèrent que par des chaînes traduites vont dans [lang] ; les pages avec de longs textes ou des textes différents ont un sous-dossier de langue explicite avec du contenu directement intégré. Ajustez ensuite la navigation dans./src/components/layout/nav/ et les autres fichiers de layout.

Remplacez les images de démo dans ./src/images (gardez la structure des dossiers !), mettez à jour ou supprimez le./public/map/office.pmtiles utilisé sur la page de contact de démo, et vérifiez les métadonnées Open Graph / X dans./src/components/head/ogx.astro.

Validez ensuite le tout :

npm run check:astro

Sur Cloudflare, ajustez _headers et _redirects dans ./public/ ainsi que lewrangler.jsonc, puis reliez votre dépôt à un Worker. Pour les migrations, mappez les anciens chemins dans _redirects. Pas sur Cloudflare ? Configurez votre hébergeur en conséquence.