Use Bun with Astro

Bun is a runtime for JavaScript built for speed. See Bun’s documentation for more information.

Using Bun with Astro still is experimental. Some integrations may not work as expected. If you have any problems using Bun, please open an issue on GitHub!

Use the following command to install Bun:

curl -fsSL https://bun.sh/install | bash

Create a new Astro project with Bun using the following create astro command:

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

If you’re starting a new project using bunx create-astro, the CLI will automatically use Bun to install dependencies and you can skip this step.

Otherwise, you’ll need to install your dependencies with Bun:

bun install

To run the development server, use the following command:

bun run dev

You can also use any of the official Astro integrations with Bun and the astro add command:

bunx astro add react

This will work exactly the same as if you were using NPM, but with the added benefit of using Bun’s blazing fast runtime.

To build and serve your site, Bun has familiar commands:

bun run build

Bun’s build command will output your site to the dist/ directory.

Then, you can serve your site using the preview command:

bun preview

More recipes