Bun-First Development

We default to Bun as our JavaScript runtime, package manager, and task runner. Assume Bun is available unless explicitly stated otherwise.

General Principles

• PREFER Bun over Node.js, npm, pnpm, or yarn
• PREFER Bun’s built-in features over third-party tools when available
• PRFER Bun's native APIs (eg for file access, SQL, S3 etc) over Node.js APIs

Package Management

• USE

  bun install

  ,

  bun add

  ,

  bun remove

• AVOID

  npm

  ,

  yarn

  ,

  pnpm

• Prefer Bun-native lockfiles and resolution behavior
• Keep dependencies minimal and intentional

Scripts & Tooling

• PREFER

  bun run

  for scripts
• AVOID Bun’s built-in test runner (

  bun test

  ) => We'll use

  Vitest

  for testing
• AVOID Bun’s build tool (

  bun build

  ) => We'll use Vite
• Avoid introducing extra task runners unless required

Runtime & APIs

• PREFER Bun’s native APIs (fetch, fs, path, env handling)
• Write code assuming modern Web APIs are available in the runtime
• Avoid Node-specific APIs unless explicitly required

Performance & DX

• Prefer simple, explicit scripts over complex toolchains
• AVOID unnecessary abstractions