Skip to content

docs(recipes/bun): Differentiate risk level in using bun as pkg manager vs runtime - #14349

Open
eugengi wants to merge 1 commit into
withastro:mainfrom
eugengi:docs-recipes-bun-add-runtime-caution
Open

docs(recipes/bun): Differentiate risk level in using bun as pkg manager vs runtime#14349
eugengi wants to merge 1 commit into
withastro:mainfrom
eugengi:docs-recipes-bun-add-runtime-caution

Conversation

@eugengi

@eugengi eugengi commented Aug 6, 2026

Copy link
Copy Markdown

Description

Follow-up suggestion to improve the clarity of the following caution in regard to using Bun in Astro projects:

Caution

Using Bun with Astro may reveal rough edges. Some integrations may not work as expected.

Minor room for improvement was identified in collaboration with @delucis on the PR referenced below.

The added context provided in this PR should help users make a definitive decision, especially if they refer to Bun's official Astro guide, which prompts them to use Bun as a runtime (via the --bun flag).

Note

By default, Bun respects the Node shebang (#!/usr/bin/env node) found at the top of executable files and automatically passes execution over to the system's Node.js runtime. To bypass this and force execution inside the Bun runtime, you must use the --bun flag

Docs

References

  • Closes: N/A
  • Related to Closed PR 14286
  • For Astro version latest
  • Discord username: @sweugene

Clarify broad Bun caution to identify different levels of risk in using
Bun as a package manager vs runtime replacement for Node.

[Note]
- This gives the user enough context if they refer to Bun's Astro guide
  which prompts them to use Bun as the runtime for Astro projects.

[Docs]
- https://bun.com/docs/guides/ecosystem/astro#build-an-app-with-astro-and-bun
@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.

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.

2 participants