Runtime (Node and Bun)
Align runtime versions and execution expectations across the team.
Recommended approach
- Use current Node LTS as baseline runtime for backend/frontend tooling.
- Use Bun selectively where ecosystem compatibility is verified.
- Lock tool versions in
.tool-versions(or equivalent).
Alternatives and when to choose them
- Node-only for maximum compatibility.
- Bun-first for teams that benchmarked compatibility and performance needs.
Implementation checklist
- Define required runtime versions in repo docs.
- Add preflight checks in CI.
- Use a version manager (for example ASDF or Volta).
Common pitfalls
- Undocumented local runtime drift between developers.
- Assuming Bun parity with every Node ecosystem package.