bun-development

Bun Development - Modern JavaScript/TypeScript Rapid Development Guide

Skill Overview

Bun Development is a development assistant skill focused on the Bun runtime, helping you develop modern JavaScript and TypeScript with Bun. It covers package management, bundling and testing, and the complete process for smooth migration from Node.js.

Use Cases

Starting a new project

When you need to create a brand new JavaScript or TypeScript project, Bun offers an exceptional developer experience — native TypeScript and JSX support that runs without configuration, built-in test framework and bundler, allowing you to start coding immediately and greatly speed up development.

Migrating from Node.js

If you’re considering migrating an existing Node.js project to a faster runtime, this skill will guide you through compatibility checks, dependency replacements, script updates, and other migration steps, helping you avoid common pitfalls.

Optimizing the development workflow

If you’re tired of slow package installs and cumbersome build configurations, Bun’s 10–100x faster installs, built-in bundler and test runner can significantly simplify your workflow.

Core Features

Project initialization and configuration

Quickly create Bun projects with bun init, automatically generating optimized tsconfig.json and package.json configurations. Supports multiple project templates (React, Next.js, Vite, Elysia, etc.), so you can start a project from scratch in seconds.

Package management and dependency operations

Manage dependencies with bun add, bun remove, and bun update, experiencing installation speeds 10–100x faster than traditional package managers. Use bunx to run package binaries directly without global installation.

Built-in development tool integration

Run TypeScript directly (no compilation step), write tests with bun test, create HTTP servers with Bun.serve, read and write files with Bun.file, and use built-in SQLite support (bun:sqlite) and password hashing — a single toolkit for full-stack development.

Frequently Asked Questions

What is Bun? How does it differ from Node.js?

Bun is a modern JavaScript/TypeScript runtime designed to be a high-performance alternative to Node.js. Major differences include: roughly 4x faster startup (~25ms vs ~100ms+), package install speeds 10–100x faster, native support for TypeScript and JSX (no transpilation needed), and built-in test framework, bundler, and SQLite support. Bun is highly compatible with Node.js, and most Node.js APIs and npm packages can be used directly.

How do I migrate a Node.js project to Bun?

The migration steps are relatively simple: first install Bun (curl -fsSL https://bun.sh/install | bash), delete node_modules and package-lock.json, then run bun install to reinstall dependencies. Update scripts in package.json (for example change node index.js to bun run index.ts, change jest to bun test), and install Bun type definitions (bun add -d @types/bun). Most code runs without modification, but be careful to avoid Node.js-specific APIs (for example, replace require.resolve with import.meta.resolve).

Does Bun support all Node.js packages?

Bun has high compatibility with the Node.js ecosystem; the vast majority of npm packages work out of the box. Bun implements Node.js core modules (such as fs, path, crypto, process, Buffer, etc.), so existing code often doesn’t require major changes. However, some packages that depend on Node.js internals or native modules may have issues. It’s recommended to test critical functionality in a development environment before migrating, or check the Bun compatibility list for detailed support: https://bun.sh/docs/runtime/nodejs-apis