Use Bun with Astro
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
PrerequisitesSection titled Prerequisites
- Bun installed locally on your machine. See the installation instructions in Bun’s official documentation.
Create a new Astro project with BunSection titled Create a new Astro project with Bun
Create a new Astro project with Bun using the following
Install dependenciesSection titled 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:
Add TypesSection titled Add Types
Bun publishes the
bun-types package, containing the runtime types for Bun.
bun-types using the following command:
Add the package to your types in
Using Astro integrationsSection titled Using Astro integrations
You can also use any of the official Astro integrations with the
astro add command:
Run Astro with BunSection titled Run Astro with Bun
Run the development serverSection titled Run the development server
To run the development server using Bun as the runtime, use the following command:
Building your site with BunSection titled Building your site with Bun
To build your site using Bun as the runtime, use the following command:
Astro will output your site to the
dist/ directory. Then, you can serve your site using the
Add SSR with Bun using Section titled Add SSR with Bun using @astrojs/node
Run the following command to add the Node.js adapter to your Astro project:
Build your site again, using the same build command as above:
Finally, use the following command to run your built site.
Testing in BunSection titled 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.
CypressSection titled 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:
For the rest of the configuration and to start your first test, follow the rest of Cypress process in the Astro Testing Guide.
PlaywrightSection titled 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:
To create your first Playwright test, follow the intructions for the rest of the Playwright process in the Astro Testing Guide.
Official ResourcesSection titled Official Resources
Community ResourcesSection titled Community Resources
Using Bun with Astro? Add your blog post or video to this page!
- Building a Cloudflare Pages site with Bun - blog post