Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eugengi wants to merge 1 commit into
base: main
Choose a base branch
from
Open

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

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion src/content/docs/en/recipes/bun.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,12 @@ i18nReady: true
[Bun](https://bun.sh/) is an all-in-one JavaScript runtime & toolkit. See [Bun's documentation](https://bun.sh/docs) 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](https://bun.sh/guides/ecosystem/astro) for details.
Bun is safe to use as your package manager (`bun install`) or script runner (`bun run` or `bunx`) in Astro projects. Think of it as a drop-in replacement for npm/pnpm/yarn.

Using Bun as your runtime (via the `--bun` flag, or a Bun-specific adapter) is _riskier_ since Bun doesn't yet have full Node.js compatibility.

If you hit a runtime issue, consider running your dev/build/deploy commands under Node while keeping Bun for installs.
Consult [Bun's official documentation for working with Astro](https://bun.sh/guides/ecosystem/astro) for details.

If you have any problems using Bun, please [open an Issue on GitHub with Bun directly](https://github.com/oven-sh/bun/issues/new/choose).
:::
Expand Down
Loading