Saltearse al contenido
Astro Astro

Usa Bun con Astro

Bun es un entorno y conjunto de herramientas de JavaScript todo en uno. Consulta la documentación de Bun para obtener más información.

Prerrequisitos

Crea un nuevo proyecto de Astro con Bun

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

Terminal window
bunx create-astro@latest my-astro-project-using-bun

Instalar dependencias

Si estás comenzando un nuevo proyecto utilizando bunx create-astro, la CLI utilizará automáticamente Bun para instalar las dependencias y puedes omitir este paso.

De lo contrario, deberás instalar tus dependencias con Bun:

Terminal window
bun install

Agrega Tipos

Bun publica el paquete bun-types, que contiene los tipos en runtime para Bun.

Instala bun-types utilizando el siguiente comando:

Terminal window
bun add -d bun-types

Agrega el paquete a tus tipos en tsconfig.json.

tsconfig.json
  "compilerOptions": {
    "types": ["bun-types"]
  }

Utilizando las integraciones de Astro

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

Terminal window
bunx astro add react

Ejecuta Astro con Bun

Ejecuta el servidor de desarrollo

Para ejecutar el servidor de desarrollo utilizando Bun como el entorno de ejecución, utiliza el siguiente comando:

Terminal window
bunx --bun astro dev

Construyendo tu sitio con Bun

Para construir tu sitio utilizando Bun como el entorno de ejecución, utiliza el siguiente comando:

Terminal window
bunx --bun astro build

Astro generará la salida de tu sitio en el directorio dist/. Luego, puedes servir tu sitio utilizando el comando preview:

Terminal window
bunx --bun astro preview

Agrega SSR con Bun usando @astrojs/node

Las características de Bun incluyen compatibilidad con la API de Node.js. Utilizando el adaptador @astrojs/node, puedes agregar renderización del lado del servidor a tu proyecto de Astro utilizando el entorno de ejecución de Bun como sustituto de Node.

Ejecuta el siguiente comando para agregar el adaptador de Node.js a tu proyecto de Astro:

Terminal window
bunx astro add node

Construye tu sitio nuevamente utilizando el mismo comando de construcción mencionado anteriormente:

Terminal window
bunx --bun astro build

Finalmente, utiliza el siguiente comando para ejecutar tu sitio construido:

Terminal window
bun ./dist/server/entry.mjs

Recursos Oficiales

Recursos de la Comunidad

¿Estás usando Bun con Astro? ¡Agrega tu entrada de blog o video a esta página!