bun-runtime

Guides adoption of Bun as JavaScript runtime, package manager, bundler, and test runner.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/inuishan/PET --skill bun-runtime-inuishan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bun-runtime
Source: https://github.com/inuishan/PET/tree/main/.codex/skills/bun-runtime
Command: npx skills add https://github.com/inuishan/PET --skill bun-runtime-inuishan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing and configuring a JavaScript toolchain involves fragmented decisions across runtimes, package managers, bundlers, and test runners, and migrating from Node to Bun raises compatibility questions. ## Core Features & Use Cases - Runtime Selection Guidance: Explains when to prefer Bun versus Node based on ecosystem compatibility and project needs. - Migration Notes: Covers replacing node/npm commands with bun equivalents, lockfile handling (bun.lock vs bun.lockb), and npm script execution via bun run. - Platform Configuration: Details Vercel deployment setup with Bun runtime, frozen-lockfile installs, and build commands. - Use Case: You are starting a new TypeScript project and want a single toolchain. Use this Skill to set up bun install, bun test, and Bun.serve for your HTTP server, then configure Vercel to deploy with the Bun runtime. ## Quick Start Ask the AI to help you migrate your Node.js project to Bun, including install commands, test setup, and Vercel deployment configuration.

Frequently Asked Questions about bun-runtime

High-intent search queries and answers about installing and using this skill.

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

Replace node script.js with bun run script.js or bun script.js, and run bun install instead of npm install. Most packages work unchanged, Node built-ins are supported, and bun x replaces npx for one-off runs.

When should I choose Bun vs Node for a project?▼

Prefer Bun for new JS/TS projects, speed-sensitive scripts, Vercel Bun deployments, and single-toolchain workflows. Prefer Node for maximum ecosystem compatibility, legacy tooling, or dependencies with known Bun issues.

Does Bun work with Vercel deployments?▼

Yes, set the runtime to Bun in Vercel project settings. Use bun run build or bun build ./src/index.ts --outdir=dist for builds, and bun install --frozen-lockfile for reproducible deploys.

How do I run tests with Bun?▼

Run bun test or bun test --watch from the command line. Write tests using the Jest-like API by importing expect and test from bun:test, with no extra test framework installation required.

What is the difference between bun.lock and bun.lockb?▼

bun.lock is the text-based lockfile used by default in current Bun versions, while bun.lockb is the binary format from older versions. Commit whichever lockfile your version generates for reproducible installs.