Usar Bun con Astro

Bun es un runtime y toolkit de JavaScript todo en uno. Consulta la documentación de Bun para más información.

Precaución

Usar Bun con Astro puede revelar bordes ásperos. Algunas integraciones pueden no funcionar como se espera. Consulta la documentación oficial de Bun para trabajar con Astro para más detalles.

Si tienes algún problema usando Bun, por favor abre un Issue en GitHub directamente con Bun.

Requisitos previos

• Bun instalado localmente en tu máquina. Consulta las instrucciones de instalación en la documentación oficial de Bun.

Crear un nuevo proyecto de Astro con Bun

Crea un nuevo proyecto de Astro con Bun usando el siguiente comando create-astro:

bun create astro my-astro-project-using-bun

Instalar dependencias

Si te saltaste el paso “¿Instalar dependencias?” durante el asistente de la CLI, asegúrate de instalar tus dependencias antes de continuar.

bun install

Añadir tipos

Bun publica el paquete @types/bun, que contiene los tipos del runtime para Bun.

Instala @types/bun usando el siguiente comando:

bun add -d @types/bun

Flags de instalación de la CLI

Usar integraciones

También puedes usar cualquiera de las integraciones oficiales de Astro con el comando astro add:

bun astro add react

Usar un tema o plantilla de inicio

Puedes iniciar un nuevo proyecto de Astro basado en un ejemplo oficial o la rama principal de cualquier repositorio de GitHub pasando un argumento --template al comando create astro.

Ejecuta el siguiente comando en tu terminal, sustituyendo el nombre de la plantilla de inicio oficial de Astro, o el usuario y repositorio de GitHub del tema que quieras usar:

# create a new project with an official example
bun create astro@latest --template <example-name>
# create a new project based on a GitHub repository’s main branch
bun create astro@latest --template <github-username>/<github-repo>

Desarrollar y compilar

Para ejecutar el servidor de desarrollo, usa el siguiente comando:

bun run dev

Compila y previsualiza tu sitio

Para compilar tu sitio, usa el siguiente comando:

bun run build

Cuando el build termine, ejecuta el comando de preview apropiado (ej. bun run preview) en tu terminal y podrás ver la versión compilada de tu sitio localmente en la misma ventana de preview del navegador.

Testing

Bun incluye un test runner rápido, integrado y compatible con Jest a través del comando bun test. También puedes usar cualquier otra herramienta de testing para Astro.

Recursos oficiales

• Construye una app con Astro y Bun

Recursos de la comunidad

¿Usas Bun con Astro? ¡Añade tu blog post o video a esta página!

• Usar Bun con Astro y Cloudflare Pages - blog post