Bun Runtime Optimization

Улучшите Claude Code с помощью навыка Bun Runtime. Оптимизируйте управление пакетами, тестирование и развёртывание для проектов на JavaScript и TypeScript с высокой скоростью.

Деплой и DevOps ★ 172,009 GitHub (172,009 ★)

Навык Bun Runtime позволяет Claude Code использовать скорость и эффективность экосистемы Bun для современной веб-разработки. Он содержит исчерпывающие инструкции по использованию Bun как универсального инструментария — заменяя медленные рабочие процессы Node.js на нативное выполнение TypeScript в Bun, молниеносное управление пакетами и встроенный фреймворк для тестирования. Будь то запуск нового проекта, миграция с Node.js или оптимизация развёртывания на Vercel — навык гарантирует, что Claude применяет лучшие практики для производительности и совместимости.

Ключевые возможности

01Нативное выполнение TypeScript и сборка без конфигурации

02Высокоскоростное управление пакетами с обработкой bun.lock

03Встроенная интеграция с тест-раннером, совместимым с Jest

04Стратегии миграции с Node.js на Bun и заметки о совместимости

05172 009 звёзд на GitHub

06Оптимизированные конфигурации для Vercel и облачного развёртывания

Варианты использования

01Миграция устаревших проектов Node.js на Bun для повышения производительности

02Разработка критичных к производительности TypeScript API и скриптов с нативной поддержкой среды выполнения

03Настройка быстрых CI/CD пайплайнов с использованием быстрой установки и циклов тестирования Bun

name	bun-runtime
description	Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.

Bun Runtime

Bun is a fast all-in-one JavaScript runtime and toolkit: runtime, package manager, bundler, and test runner.

When to Use

Prefer Bun for: new JS/TS projects, scripts where install/run speed matters, Vercel deployments with Bun runtime, and when you want a single toolchain (run + install + test + build).
Prefer Node for: maximum ecosystem compatibility, legacy tooling that assumes Node, or when a dependency has known Bun issues.

Use when: adopting Bun, migrating from Node, writing or debugging Bun scripts/tests, or configuring Bun on Vercel or other platforms.

How It Works

Runtime: Drop-in Node-compatible runtime (built on JavaScriptCore, implemented in Zig).
Package manager: bun install is significantly faster than npm/yarn. Lockfile is bun.lock (text) by default in current Bun; older versions used bun.lockb (binary).
Bundler: Built-in bundler and transpiler for apps and libraries.
Test runner: Built-in bun test with Jest-like API.

Migration from Node: Replace node script.js with bun run script.js or bun script.js. Run bun install in place of npm install; most packages work. Use bun run for npm scripts; bun x for npx-style one-off runs. Node built-ins are supported; prefer Bun APIs where they exist for better performance.

Vercel: Set runtime to Bun in project settings. Build: bun run build or bun build ./src/index.ts --outdir=dist. Install: bun install --frozen-lockfile for reproducible deploys.

Examples

Run and install

# Install dependencies (creates/updates bun.lock or bun.lockb)
bun install

# Run a script or file
bun run dev
bun run src/index.ts
bun src/index.ts

Scripts and env

bun run --env-file=.env dev
FOO=bar bun run script.ts

Testing

bun test
bun test --watch

// test/example.test.ts
import { expect, test } from "bun:test";

test("add", () => {
  expect(1 + 2).toBe(3);
});

Runtime API

const file = Bun.file("package.json");
const json = await file.json();

Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response("Hello");
  },
});

Best Practices

Commit the lockfile (bun.lock or bun.lockb) for reproducible installs.
Prefer bun run for scripts. For TypeScript, Bun runs .ts natively.
Keep dependencies up to date; Bun and the ecosystem evolve quickly.

🚀 Что это

Навык Bun Runtime Optimization — это гайд по использованию Bun как альтернативы Node.js в разработке и деплое. Bun — это не просто рантайм, а полный инструментарий: менеджер пакетов (bun install), бандлер (вместо Webpack/Rollup), транспайлер TypeScript и тест-раннер с API, совместимым с Jest. Основная цель — ускорить разработку и упростить тулчейн, объединив несколько инструментов в одном бинарнике.

Навык помогает ответить на вопросы: когда стоит переходить на Bun, а когда оставаться на Node, как перенести проект, как настроить Bun для Vercel и как эффективно его использовать в повседневной работе.

⚙️ Как работает

🏃 Рантайм

Bun построен на движке JavaScriptCore (а не V8, как Node) и написан на Zig. Это даёт более быстрый старт и меньшее потребление памяти во многих сценариях. Он поддерживает большинство Node.js API (fs, path, http и т.д.) — поэтому существующий код часто работает без изменений. Однако Bun предлагает собственные, более производительные API (например, Bun.file, Bun.serve, Bun.write).

📦 Менеджер пакетов

bun install работает значительно быстрее npm install и yarn, особенно при первом запуске (кэширование агрессивное). Файл блокировки — bun.lock (текстовый в версиях >=1.0) или bun.lockb (бинарный в ранних версиях). Рекомендуется коммитить bun.lock в репозиторий для воспроизводимых установок.

🔨 Бандлер и транспайлер

Bun умеет собирать проекты без дополнительных настроек: bun build ./src/index.ts --outdir=dist. TypeScript и JSX поддерживаются из коробки, без установки tsc или webpack. Это удобно для небольших скриптов, библиотек и серверных приложений.

🧪 Тест-раннер

bun test имеет API, похожий на Jest, но работает быстрее и использует тот же кэш, что и сам Bun. Пример теста:

bun test

// test/example.test.ts
import { expect, test } from "bun:test";
test("add", () => {
  expect(1 + 2).toBe(3);
});

🔄 Миграция с Node.js

Основные правила:

Вместо node script.js — bun run script.js или просто bun script.js.
Вместо npx cowsay — bun x cowsay.
Вместо npm install — bun install.
Скрипты из package.json запускаются командой bun run script-name``.

Node-зависимости (Express, Prisma и т.д.) в большинстве работают, но есть редкие проблемы с нативными модулями, завязанными на Node C++ API. В таких случаях лучше остаться на Node.

🌐 Деплой на Vercel

Vercel поддерживает Bun как рантайм для Serverless-функций и Edge-функций. В настройках проекта нужно выбрать Bun (а не Node.js). Команда сборки: bun run build или bun build ./src/index.ts --outdir=dist. Для установки зависимостей в CI/Vercel используйте:

bun install --frozen-lockfile

Это гарантирует фиксацию версий из bun.lock и предотвратит неожиданные изменения.

✅ Когда использовать

Навык пригодится в следующих сценариях:

🆕 Запуск нового проекта на JavaScript/TypeScript: используйте Bun с нуля, чтобы получить единый тулчейн.
🔄 Миграция существующего Node-проекта: если нет критичных нативных зависимостей, Bun может дать прирост скорости.
🚀 Оптимизация скорости разработки: быстрый bun install, быстрый запуск тестов, нативный TypeScript.
☁️ Деплой на Vercel: если вы хотите использовать Bun runtime для меньшего времени холодного старта и простоты конфигурации.
🧪 Скрипты и одноразовые задачи: bun run быстрее node run, а bun x заменяет npx.

⚠️ Важно знать

Совместимость: Bun не на 100% совместим с Node.js. Некоторые глобальные объекты (process.nextTick), нативные модули (bcrypt, sharp) и специфика поведения (таймеры, Buffer) могут отличаться. Проверяйте зависимости на официальной странице совместимости Bun.
Стабильность: Всё ещё активно развивается (версии 1.x). API Bun (Bun.serve, Bun.file) стабильны, но могут меняться незначительно. Рекомендуется следить за changelog.
Lockfile: До версии 1.0 использовался бинарный bun.lockb. Если вы находитесь на старой версии и переходите на новую, lockfile будет перегенерирован. Коммитьте его, чтобы избежать сюрпризов в CI.
Переменные окружения: Можно передавать как обычно (FOO=bar bun run script.ts) или через файл: bun run --env-file=.env dev.
Для продакшена: Bun сам по себе — рантайм, поэтому на сервере Vercel, Railway, Fly.io и т.д. вы указываете его как рантайм. На собственном сервере нужно установить бинарник Bun.

Подытожим: навык даёт чёткую дорожную карту: как начать, на что обратить внимание при миграции, как настроить CI/CD и тесты. Это инструкция для разработчика, который хочет получить от Bun максимум скорости и удобства без лишних танцев с бубном.

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code bun-runtime

Источник: https://mcpmarket.com/tools/skills/bun-runtime-optimization