Installation d'Astro avec l'ILC automatique

Prêt à installer Astro ? Suivez ce guide pour utiliser la CLI create astro pour commencer.

• Node.js - version v16.12.0 ou supérieure.
• Éditeur de code - Nous recommandons VS Code avec notre extension officielle Astro.
• Console de terminal - Astro est accessible via son interface par ligne de commande (ILC).

create-astro est le moyen le plus rapide pour démarrer un nouveau projet Astro à partir de zéro. Il vous guidera lors de chaque étape d’installation de votre nouveau projet Astro. Il vous permet de choisir entre différents templates de démarrage ou fournir le votre en utilisant l’argument --template.

Exécutez la commande suivante dans votre terminal pour démarrer notre assistant d’installation pratique :

# créer un nouveau projet avec npm
npm create astro@latest

# créer un nouveau projet avec pnpm
pnpm create astro@latest

# créer un nouveau projet avec yarn
yarn create astro

Vous pouvez exécuter create astro n’importe où sur votre machine, il n’est donc pas nécessaire de créer un nouveau répertoire vide pour votre projet avant de commencer. Si vous n’avez pas encore de répertoire vide pour votre nouveau projet, l’assistant en créera automatiquement un pour vous.

Si tout se passe bien, vous devriez voir un message “Ready for liftoff!” suivi de quelques “Étapes suivantes”. Exécutez cd vers votre nouveau répertoire pour commencer à utiliser Astro.

Si vous avez manqué l’étape npm install durant l’assistant create-astro, veuillez vous assurer d’installer les dépendances avant de continuer.

Avec Astro, vous disposez d’un serveur de développement intégré qui regroupe toutes les fonctionnalités nécessaires pour la réalisation de votre projet. La commande astro dev démarrera le serveur de développement local pour que vous puissiez voir votre nouveau site web en action pour la toute première fois.

Chaque modèle de départ est livré avec un script préconfiguré qui exécutera astro dev pour vous. Utilisez votre gestionnaire de paquets préféré pour exécuter cette commande et démarrer le serveur de développement d’Astro.

npm run dev

pnpm run dev

yarn run dev

Si tout se passe comme prévu, Astro devrait maintenant être en train de faire tourner votre projet à l’addresse http://localhost:3000/ !

Astro va également suivre les modifications de fichiers dans le répertoire src/, vous n’aurez donc pas besoin de redémarrer le serveur à chaque fois que vous apporterez des modifications au cours du développement.

Si vous n’arrivez pas à ouvrir votre projet dans le navigateur, revenez au terminal où vous avez lancé le script dev pour voir ce qui a mal tourné, ou si votre projet est servi sur une url différente que celle mentionnée ci-dessus.

Vous pouvez également démarrer un nouveau projet Astro basé sur un dépôt GitHub existant en passant un argument --template à la commande create astro.

npm create astro@latest -- --template <nom-d-utilisateur-github>/<depot-github>

pnpm create astro@latest --template <nom-d-utilisateur-github>/<depot-github>

yarn create astro --template <nom-d-utilisateur-github>/<depot-github>

Explorez notre galerie de thèmes et de modèles de démarrage où vous pouvez parcourir des thèmes pour des blogs, des portfolios, de la documentation, des landing page, et plus encore ! Ou, recherchez sur GitHub pour encore plus de projets de démarrage.

Bravo ! Vous êtes maintenant prêt à développer avec Astro ! 🥳

Voici quelques sujets que nous vous recommandons d’explorer ensuite. Vous pouvez les lire dans n’importe quel ordre. Vous pouvez même quitter notre documentation pour un moment et aller jouer dans votre nouveau codebase de projet Astro, revenant ici chaque fois que vous rencontrez des problèmes ou avez des questions.

📚 Ajoutez un framework: Apprenez à étendre Astro avec un support pour React, Svelte, Tailwind et plus encore en utilisant npx astro add dans notre guide d’intégrations.

📚 Déployez votre site: Apprenez à construire et déployer un projet Astro sur le web dans notre guide de déploiement.

📚 Comprenez votre projet: En savoir plus sur la structure de projet d’Astro dans notre guide de la structure de projet.