# Bun (Experimental) Documentation

## Overview

This page documents experimental Bun runtime support for the repository. Bun is an optional local runtime for running TypeScript directly (`bun run …`, `bun --watch …`).

## Key Points

**Installation approach:** Users can install dependencies using `bun install` or `bun install --no-save` to prevent lockfile generation.

**Build and testing:** The commands `bun run build` and `bun run vitest run` execute build and test operations respectively.

**Production considerations:** Not recommended for Gateway runtime (WhatsApp/Telegram bugs). Use Node for production.

**Lifecycle scripts:** Bun may initially block certain dependency installation scripts. However, for this specific repository, the commonly blocked scripts aren't necessary for operation. Users can trust problematic scripts via `bun pm trust` if needed.

**Limitations:** Some npm scripts still require pnpm, particularly documentation and UI-related commands.

## Bottom Line

Bun serves as an optional development alternative to pnpm but remains unsuitable for production gateway deployments involving WhatsApp or Telegram integrations.
