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