Uso de CLI bun build

bun build <entry points>

Configuración General

--productionboolean

Establece NODE_ENV=production y habilita la minificación

--bytecodeboolean

Usa un caché de bytecode al compilar

--targetstring default: browser

Entorno de ejecución previsto para el paquete. Uno de browser, bun, o node

--conditionsstring

Pasa condiciones de resolución personalizadas

--envstring default: disable

Incrusta variables de entorno en el paquete como process.env.${name}. Para incrustar variables que coincidan con un prefijo, usa un comodín como FOO_PUBLIC_*

Salida y Manejo de Archivos

--outdirstring default: dist

Directorio de salida (usado al construir múltiples puntos de entrada)

--outfilestring

Escribe la salida en un archivo específico

--sourcemapstring default: none

Genera source maps. Uno de linked, inline, external, o none

--bannerstring

Agrega un banner a la salida (ej. "use client" para React Server Components)

--footerstring

Agrega un footer a la salida (ej. // built with bun!)

--formatstring default: esm

Formato de módulo del paquete de salida. Uno de esm, cjs, o iife

Nomenclatura de Archivos

--entry-namingstring default: [dir]/[name].[ext]

Personaliza los nombres de archivos de los puntos de entrada

--chunk-namingstring default: [name]-[hash].[ext]

Personaliza los nombres de archivos de los chunks

--asset-namingstring default: [name]-[hash].[ext]

Personaliza los nombres de archivos de los recursos

Opciones de Empaquetado

--rootstring

Directorio raíz usado al empaquetar múltiples puntos de entrada

--splittingboolean

Habilita code splitting para módulos compartidos

--public-pathstring

Prefijo a agregar a las rutas de importación en el código empaquetado

--externalstring

Excluye módulos del paquete (soporta comodines). Alias: -e

--packagesstring default: bundle

Cómo tratar las dependencias: external o bundle

--no-bundleboolean

Solo transpila — no empaqueta

--css-chunkingboolean

Agrupa archivos CSS para reducir duplicación (solo cuando múltiples puntos de entrada importan CSS)

Minificación y Optimización

--emit-dce-annotationsboolean default: true

Re-emite anotaciones de Eliminación de Código Muerto. Deshabilitado cuando se usa --minify-whitespace

--minifyboolean

Habilita todas las opciones de minificación

--minify-syntaxboolean

Minifica sintaxis e incrusta constantes

--minify-whitespaceboolean

Minifica espacios en blanco

--minify-identifiersboolean

Minifica identificadores de variables y funciones

--keep-namesboolean

Preserva los nombres originales de funciones y clases al minificar

Características de Desarrollo

--watchboolean

Reconstruye automáticamente cuando los archivos cambian

--no-clear-screenboolean

No limpia la terminal al reconstruir con --watch

--react-fast-refreshboolean

Habilita la transformación React Fast Refresh (para pruebas de desarrollo)

Ejecutables Independientes

--compileboolean

Genera un ejecutable Bun independiente que contiene el paquete. Implica --production

--compile-exec-argvstring

Antepone argumentos al execArgv del ejecutable independiente

Detalles de Ejecutables Windows

--windows-hide-consoleboolean

Previene que se abra una ventana de consola al ejecutar un ejecutable Windows compilado

--windows-iconstring

Establece un icono para el ejecutable Windows

--windows-titlestring

Establece el nombre del producto del ejecutable Windows

--windows-publisherstring

Establece el nombre de la empresa del ejecutable Windows

--windows-versionstring

Establece la versión del ejecutable Windows (ej. 1.2.3.4)

--windows-descriptionstring

Establece la descripción del ejecutable Windows

--windows-copyrightstring

Establece el aviso de derechos de autor del ejecutable Windows

Experimental y Construcción de Aplicaciones

--appboolean

(EXPERIMENTAL) Construye una aplicación web para producción usando Bun Bake

--server-componentsboolean

(EXPERIMENTAL) Habilita React Server Components

--debug-dump-server-filesboolean

Cuando --app está establecido, vuelca todos los archivos del servidor al disco incluso para compilaciones estáticas

--debug-no-minifyboolean

Cuando --app está establecido, deshabilita toda la minificación