Heldinhow Bun Runtime
Overview
Bun is an all-in-one JavaScript runtime designed for speed, with built-in package manager, test runner, and bundler. This skill should be invoked when you need fast JavaScript/TypeScript execution, a streamlined development experience, or want to reduce toolchain complexity.
Core Principles
- All-in-One: Use Bun for runtime, package management, testing, and building
- Speed First: Bun is significantly faster than Node.js for most operations
- Node Compatibility: Most Node.js code works with Bun
- Built-in APIs: Use Bun's native APIs (Bun.file, Bun.serve, etc.)
Preparation Checklist
- Install Bun:
curl -fsSL https://bun.sh/install | bash - Verify installation:
bun --version - Review Bun's API differences from Node.js
- Check compatibility of required packages
Step-by-Step Process
- Initialize: Run
bun initto create new project - Install: Use
bun add <package>instead of npm install - Write Code: Use TypeScript directly with Bun APIs
- Run: Execute with
bun run <script> - Test: Use
bun testfor running test suites - Deploy: Deploy to Bun-compatible platforms (Railway, Render, etc.)
Do's and Don'ts
- ✅ Do use Bun's built-in APIs for better performance
- ✅ Do use
bun testfor fast test execution - ✅ Do check Bun's compatibility before choosing for production
- ❌ Don't assume all Node.js packages work perfectly
- ❌ Don't ignore Bun's different global objects
- ❌ Don't use npm-specific features not in Bun
Anti-Patterns
- Node Assumption: Assuming all Node.js APIs work identically
- Package Overlap: Mixing bun install with npm/yarn
- Ignoring Warnings: Not checking Bun's compatibility warnings
- Production Blindness: Using Bun in production without testing edge cases