Skip to content

docs: use the Bun runtime#13808

Closed
weakish wants to merge 1 commit into
withastro:mainfrom
weakish:bun-runtime
Closed

docs: use the Bun runtime#13808
weakish wants to merge 1 commit into
withastro:mainfrom
weakish:bun-runtime

Conversation

@weakish
Copy link
Copy Markdown

@weakish weakish commented May 1, 2026

By default, bun run starts the Astro dev server on the Node.js runtime.
This change adds instructions for using the Bun runtime instead.

Reasons:

  1. Users running Astro with Bun may prefer to use the Bun runtime.
  2. The CI and production environments may only include Bun, not Node.js; configuring Bun runtime keeps development, CI, and production consistent.
  3. Bun’s official Astro guide also documents using the Bun runtime:
    https://bun.com/docs/guides/ecosystem/astro

By default, `bun run` starts the Astro dev server on the Node.js runtime.
This change adds instructions for using the Bun runtime instead.

Reasons:

1. Users running Astro with Bun may prefer to use the Bun runtime.
2. The CI and production environments may only include Bun, not Node.js; configuring Bun runtime keeps development, CI, and production consistent.
3. Bun’s official Astro guide also documents using the Bun runtime:
   https://bun.com/docs/guides/ecosystem/astro
@netlify
Copy link
Copy Markdown

netlify Bot commented May 1, 2026

Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 7e6d404
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/69f4231b91561c0008b191cc
😎 Deploy Preview https://deploy-preview-13808--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@astrobot-houston
Copy link
Copy Markdown
Contributor

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

  1. Our GitHub bots will run to check your changes.
    If they spot any broken links you will see some error messages on this PR.
    Don’t hesitate to ask any questions if you’re not sure what these mean!

  2. In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.

  3. One or more of our maintainers will take a look and may ask you to make changes.
    We try to be responsive, but don’t worry if this takes a few days.

@astrobot-houston
Copy link
Copy Markdown
Contributor

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/recipes/bun.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@ArmandPhilippot
Copy link
Copy Markdown
Member

Thanks for willing to contribute but I'm not convinced we should add this to the documentation.

The reasons given don't change the fact that Astro doesn't support the Bun runtime. Adding this mention could encourage users down an unsupported path.

And, please read our contributing guide. These kinds of addition should start with a Discussion. This is not a "very obvious documentation fixes like typos or broken links".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants