bun-runtime

# Bun Runtime Workflows

Leverage Bun's integrated toolkit for faster development. From one-off commands with bunx to optimizing monorepos, master the workflows that keep full-stack teams moving.

## Why Bun?

Bun is a **complete toolkit** in a single binary:
- **Runtime** — JavaScript/TypeScript execution (4x faster Node startup)
- **Package Manager** — Replaces npm/yarn (faster installs)
- **Bundler** — Built-in code bundling
- **Test Runner** — Native test framework (no external runners)

All in one. No configuration. No separate tools.

---

## 1. bunx: No Global Installs

Replace globally installed CLI tools with `bunx`. Each command runs the latest version without cluttering your environment.

### Pattern: Use bunx Instead of Global npm

```bash
# ❌ Old way (npm)
npm install -g eslint
npx eslint .

# ✅ New way (Bun)
bunx eslint .
bunx eslint --fix .

# Always uses latest version, no global pollution
```

### Common bunx Commands

```bash
# Create projects
bunx create-vite@latest my-app --template react-ts
bunx create-next-app@latest my-blog

# Run tools
bunx eslint . --fix
bunx prettier . --write
bunx tsc --noEmit

# Utilities
bunx tsx script.ts          # Run TypeScript directly
bunx esbuild app.ts         # Bundle app
bunx http-server .          # Quick HTTP server
```

### Why bunx?

- **No global cluttering** — Each tool installs to temp directory
- **Version consistency** — Everyone uses the latest (or pinned) version
- **Faster** — No global npm cache to manage
- **Reproducible** — Same versions across developers and CI

---

## 2. Bun Workspaces: Monorepo Management

Define workspaces in root `package.json` for seamless monorepo management.

### Setup

```json
{
  "name": "my-workspace",
  "private": true,
  "workspaces": [
    "packages/*",
    "apps/*",
    "plugins/*"
  ]
}
```

### Directory Structure

```
my-workspace/
├── package.json              # Root (defines workspaces)
├── packages/
│   ├── core/                # Shared library
│   │   ├── p