Commandes

Toutes les commandes se lancent depuis la racine du projet. Prérequis : Node.js ≥ 22 (ici via nvm : nvm use 24).

Scripts npm du projet

Définis dans la section scripts de package.json :

Commande	Équivaut à	Rôle
npm install	—	Installe les dépendances dans node_modules/
npm run dev	astro dev	Serveur de développement avec rechargement à chaud (port 4321)
npm run build	astro build	Compile le site statique dans dist/
npm run preview	astro preview	Sert dist/ (port 4321)
npm run serve	python3 -m http.server	Sert dist/ sans Astro (port 8080)
npm run serve:nginx	docker run … nginx	Sert dist/ avec Nginx (port 8081)
npm run cms	decap-server	Serveur local de Decap CMS (port 8082), à lancer avec npm run dev — voir Decap CMS : architecture

Commandes Astro utiles

Lancées via npx astro … :

Commande	Rôle
npx astro check	Vérifie les types et le contenu sans compiler
npx astro sync	Régénère les types de .astro/ après un changement de schéma
npx astro add <intégration>	Ajoute une intégration (ex. npx astro add sitemap)
npx astro dev --host	Rend le serveur de dev accessible depuis le réseau local
npx astro telemetry disable	Désactive l’envoi de statistiques anonymes

Mettre à jour Astro et Starlight

npx @astrojs/upgrade

Starlight étant encore en version 0.x, une mise à jour peut introduire des changements incompatibles : lire le journal des modifications avant.