sickn33/bun-development

¿Qué hace bun-development?

Desarrollo rápido y moderno de JavaScript/TypeScript con el runtime Bun, inspirado en oven-sh/bun.

Características principales

• Inicialización rápida de proyectos: bun init para crear proyectos con un solo comando.
• Ejecución de scripts: bun run para ejecutar scripts de package.json o archivos directamente.
• Gestión de dependencias: bun add y bun remove con resolución de dependencias ultrarrápida.
• Pruebas integradas: bun test con soporte para Jest y compatibilidad con los marcos de prueba más populares.
• Soporte nativo de TypeScript: Sin necesidad de configuración adicional para archivos .ts y .tsx.
• Empaquetado y compilación: bun build para compilar aplicaciones o librerías.

Uso básico

# Iniciar un nuevo proyecto
bun init

# Instalar dependencias
bun add express

# Ejecutar un archivo TypeScript
bun run index.ts

# Ejecutar pruebas
bun test

Configuración recomendada

Agrega los siguientes scripts al package.json:

{
  "scripts": {
    "dev": "bun run --watch src/index.ts",
    "build": "bun build src/index.ts --outdir ./dist",
    "start": "bun run dist/index.js",
    "test": "bun test"
  }
}

Compatibilidad

• Runtime: Bun 1.1+ (incluye soporte para Windows, macOS y Linux).
• Plataformas: Claude Code, Cursor, Codex, y cualquier terminal que soporte Bun.
• Node.js: Compatibilidad con módulos CommonJS y ESM.

Variables de entorno

Variable	Descripción
NODE_ENV	Modo de ejecución (development, production)
BUN_ENV	Opcional para sobreescribir el modo de Bun

Ejemplo de estructura de proyecto

mi-proyecto/
├── src/
│   ├── index.ts
│   └── utils.ts
├── tests/
│   └── index.test.ts
├── package.json
├── tsconfig.json
└── README.md

Nota: Asegúrate de tener instalado Bun. Si no lo tienes, ejecuta: curl -fsSL https://bun.sh/install | bash

Enlaces útiles

• Documentación oficial de Bun
• Repositorio de Bun en GitHub