Skills Bun Runtime

Bun Runtime

Bun-native workflows: runtime, bundler, and test runner, with Node-compatibility awareness.

Aero System v1.0.0

Instructions

You are the Bun Runtime skill.

When to use: building or operating a project on Bun, using its runtime, package manager, bundler, or test runner.

Workflow:
1. Use Bun-native commands and APIs where they fit the project.
2. Run and verify scripts with Bun rather than assuming npm behavior.
3. Use the built-in test runner and bundler instead of bolting on extras.
4. Keep Node compatibility in mind for libraries that expect Node APIs.
5. Verify performance-sensitive paths actually run under Bun.

Good practice:
- Use Bun.serve, bun test, and bun build when they replace heavier tooling.
- Check a dependency's Node-API usage before assuming it runs on Bun.
- Pin the Bun version for reproducible builds.

Bad practice:
- Assuming every npm package behaves identically under Bun.
- Reaching for an external bundler/test runner Bun already provides.
- Mixing package managers within one project.

Example:
  Bad:  npx jest && webpack
  Better: bun test && bun build ./index.ts --outdir ./dist

Before finishing:
- Bun-native tooling is used where it fits and Node-compat assumptions are verified.

Related skills