Bun Runtime

Расширьте возможности Claude Code с помощью навыка Bun Runtime. Ускорьте JS/TS разработку с высокопроизводительным управлением пакетами, тестированием и поддержкой развертывания на Vercel.

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

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

Ключевые особенности

01Встроенный, совместимый с Jest, тест-раннер для быстрого модульного тестирования

02Нативное выполнение TypeScript и JSX без внешних транспилеров

03Полные руководства по миграции с Node.js на экосистему Bun

04172 009 звёзд на GitHub

05Быстрое управление пакетами с автоматической работой с lock-файлами

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

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

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

02Создание новых full-stack TypeScript приложений с единым инструментарием

03Ускорение CI/CD пайплайнов с помощью быстрой установки зависимостей и тестирования

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

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 — это быстрый, всё-в-одном инструмент для разработки на JavaScript и TypeScript. Он заменяет сразу несколько утилит: рантайм (как Node.js), менеджер пакетов (npm/yarn), сборщик (webpack/rollup) и тестовый раннер (Jest/Vitest). Bun написан на Zig и использует движок JavaScriptCore, что даёт значительный прирост скорости при установке зависимостей, запуске скриптов и выполнении тестов. Навык помогает разобраться, когда выбирать Bun вместо Node, как мигрировать существующий проект и как настроить Bun на Vercel.

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

🏃 Runtime

Bun — это drop-in замена Node.js для большинства сценариев. Он поддерживает встроенные модули Node (fs, path, http и др.) и работает с TypeScript «из коробки» — не нужна отдельная компиляция. Запустить файл можно командами bun run script.ts или просто bun script.ts. Для скриптов из package.json используйте bun run dev, bun run build и т.д.

📦 Package manager

Команда bun install устанавливает зависимости в разы быстрее npm/yarn. Lock-файл по умолчанию — текстовый bun.lock (в новых версиях Bun), в старых — бинарный bun.lockb. Рекомендуется коммитить lock-файл в репозиторий для воспроизводимых установок. Для CI/CD используйте bun install --frozen-lockfile.

🔨 Bundler

Встроенный сборщик и транспилятор позволяет собирать приложения и библиотеки без дополнительных инструментов. Пример сборки:

bun build ./src/index.ts --outdir=dist

🧪 Test runner

bun test — встроенный тестовый раннер с API, похожим на Jest. Поддерживает watch-режим (bun test --watch), моки, снапшоты. Пример теста:

bun test

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

🔄 Миграция с Node

Основные шаги:

Заменить node script.js на bun run script.js или bun script.js.
Вместо npm install выполнять bun install.
Для однократного запуска утилит (аналог npx) — bun x package``.
Node-совместимые модули работают, но для максимальной производительности лучше использовать нативные Bun API, например Bun.file() вместо fs.readFileSync.

☁️ Vercel

В настройках проекта на Vercel нужно указать рантайм Bun. Команды для сборки и установки:

bun install --frozen-lockfile
bun run build

Или напрямую bun build ./src/index.ts --outdir=dist.

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

Выбирайте Bun, если:

Начинаете новый проект на JS/TS и хотите единый инструментарий.
Скорость установки зависимостей и запуска скриптов критична (CI/CD, локальная разработка).
Планируете деплой на Vercel с поддержкой Bun.
Нужен быстрый тестовый раннер с привычным Jest-подобным API.

Оставайтесь на Node, если:

Проект использует устаревшие зависимости, которые могут быть несовместимы с Bun.
Требуется максимальная совместимость с экосистемой npm (некоторые пакеты всё ещё имеют баги под Bun).
Используете инструменты, завязанные на Node (например, некоторые плагины Webpack).

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

Lock-файл (bun.lock или bun.lockb) обязательно коммитить — это гарантирует воспроизводимость установок.
Bun активно развивается, поэтому регулярно обновляйте его и зависимости.
Для работы с переменными окружения используйте флаг --env-file: bun run --env-file=.env dev.
Встроенные Bun API (Bun.serve, Bun.file, Bun.write) часто быстрее аналогов из Node, но не всегда полностью взаимозаменяемы — проверяйте документацию.

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

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

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

Bun Runtime

Ключевые особенности

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

Bun Runtime

When to Use

How It Works

Examples

Run and install

Scripts and env

Testing

Runtime API

Best Practices

🧰 Что это

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

🏃 Runtime

📦 Package manager

🔨 Bundler

🧪 Test runner

🔄 Миграция с Node

☁️ Vercel

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

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

Можно ли использовать Bun для тестирования с этим навыком?

Как навык Bun помогает при миграции с Node.js?

Как развернуть проекты Bun на Vercel с помощью этого навыка?

Поддерживает ли этот навык TypeScript нативно?

Когда стоит выбрать Bun вместо Node.js?

Комментарии