Skip to content

Latest commit

 

History

History
137 lines (86 loc) · 4.14 KB

bun.mdx

File metadata and controls

137 lines (86 loc) · 4.14 KB
Raw
title description type i18nReady
Use Bun with Astro
Learn how to use Bun with your Astro site.
recipe
true

Bun is an all-in-one JavaScript runtime & toolkit. See Bun's documentation for more information.

:::caution Using Bun with Astro may reveal rough edges. Some integrations may not work as expected. Consult Bun's official documentation for working with Astro for details.

If you have any problems using Bun, please open an Issue on GitHub with Bun directly. :::

Prerequisites

Create a new Astro project with Bun

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

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

:::tip You may also create a new Astro project from any existing Astro GitHub repository using the --template flag:

bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal

:::

Install dependencies

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

Add Types

Bun publishes the @types/bun package, containing the runtime types for Bun.

Install @types/bun using the following command:

bun add -d @types/bun

Using Astro integrations

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

bunx astro add react

Run Astro with Bun

:::note Use the --bun CLI flag before every astro command to use Bun's own runtime in place of Node. :::

Run the development server

To run the development server using Bun as the runtime, use the following command:

bunx --bun astro dev

Building your site with Bun

To build your site using Bun as the runtime, use the following command:

bunx --bun astro build

Astro will output your site to the dist/ directory. Then, you can serve your site using the preview command:

bunx --bun astro preview

Add SSR with Bun

Since Bun features Node.js API compatibility, you can use any Astro adapter for server-side rendering to your Astro project:

bunx astro add vercel

Testing in Bun

Bun ships with a fast, built-in, Jest-compatible test runner through the bun test command. If you like to use that read bun test documentation.

However, it is also possible to use Cypress or Playwright for a modern approach to testing web apps.

Cypress

Cypress is a front-end testing tool and is on a mission to "make the testing experience enjoyable and generate developer happiness". This enables you to write end-to-end tests for your Astro site.

Install Cypress with the following command:

bun add cypress --dev

For the rest of the configuration and to start your first test, follow the rest of Cypress process in the Astro Testing Guide.

Playwright

Playwright is an end-to-end testing framework that allows you to test your Astro code on all modern rendering engines including Chromium, WebKit, and Firefox.

Install Playwright using the following command:

bun create playwright

To create your first Playwright test, follow the instructions for the rest of the Playwright process in the Astro Testing Guide.

Official Resources

Community Resources

Using Bun with Astro? Add your blog post or video to this page!