Utiliser Bun avec Astro

Bun est un moteur d’exécution et une boîte à outils JavaScript tout-en-un. Voir la documentation de Bun pour plus d’informations.

Attention

L’utilisation de Bun avec Astro peut révéler des imperfections. Certaines intégrations peuvent ne pas fonctionner comme prévu. Consultez la documentation officielle de Bun pour travailler avec Astro pour plus de détails.

Si vous rencontrez des problèmes lors de l’utilisation de Bun, veuillez signaler un problème sur GitHub avec Bun directement.

Prérequis

• Bun installé localement sur votre machine. Voir les instructions d’installation dans la documentation officielle de Bun.

Créer un nouveau projet Astro avec Bun

Créez un nouveau projet Astro avec Bun en utilisant la commande create-astro suivante :

bun create astro mon-projet-astro-utilisant-bun

Installer les dépendances

Si vous avez ignoré l’étape « Installer les dépendances ? » dans l’assistant CLI, assurez-vous d’installer vos dépendances avant de continuer.

bun install

Ajouter des types

Bun publie le paquet @types/bun, contenant les types d’exécution pour Bun.

Installez @types/bun en utilisant la commande suivante :

bun add -d @types/bun

Options d’installation de la CLI

Utiliser des intégrations

Vous pouvez également utiliser l’une des intégrations officielles d’Astro avec la commande astro add :

bun astro add react

Utiliser un thème ou un modèle de démarrage

Vous pouvez démarrer un nouveau projet Astro reposant sur un exemple officiel ou la branche principale de n’importe quel dépôt GitHub en passant un argument --template à la commande create astro.

Exécutez la commande suivante dans votre terminal, en remplaçant le nom officiel du modèle de démarrage d’Astro ou le nom d’utilisateur GitHub et le dépôt du thème que vous souhaitez utiliser :

# créer un nouveau projet avec un exemple officiel
bun create astro@latest --template <nom-exemple>
# créer un nouveau projet reposant sur la branche principale d'un dépôt GitHub
bun create astro@latest --template <nom-utilisateur-github>/<depot-github>

Développer et compiler

Pour exécuter le serveur de développement, utilisez la commande suivante :

bun run dev

Compiler et prévisualiser votre site

Pour compiler votre site, utilisez la commande suivante :

bun run build

Une fois la compilation terminée, exécutez la commande d’aperçu appropriée (par exemple bun run preview) dans votre terminal et vous pourrez afficher la version compilée de votre site localement dans la même fenêtre d’aperçu du navigateur.

Tests

Bun est fourni avec un exécuteur de tests rapide, intégré et compatible avec Jest via la commande bun test. Vous pouvez également utiliser d’autres outils de test pour Astro.

Ressources officielles

• Construire une application avec Astro et Bun

Ressources communautaires

Vous utilisez Bun avec Astro ? Ajoutez votre article de blog ou votre vidéo à cette page !

• Construire un site Cloudflare Pages avec Bun - article de blog
• Utiliser Bun avec Astro et Cloudflare Pages - article de blog