Bun build command

Basic Usage

To build a JavaScript or TypeScript file into an executable, you can use the following syntax:

bun build --compile ./path/to/your/app.ts --outfile yourapp

This command compiles the specified file (`app.ts`) into an executable named `yourapp`. The `--compile` flag indicates that you want to generate a standalone binary.

Cross-Compilation

Bun also supports cross-compilation, allowing you to create executables for different platforms. You can specify the target platform using the `--target` option. For example:

- To build for Linux x64:

  bun build --compile --target=bun-linux-x64 ./index.ts --outfile myapp
  

- To build for Windows x64:

  bun build --compile --target=bun-windows-x64 ./path/to/my/app.ts --outfile myapp
  

- For macOS x64:

  bun build --compile --target=bun-darwin-x64 ./path/to/my/app.ts --outfile myapp
  

Supported Targets

Bun supports various targets, which include:

| Target | Operating System | Architecture |
|----------------------|------------------|--------------|
| bun-linux-x64 | Linux | x64 |
| bun-linux-arm64 | Linux | arm64 |
| bun-windows-x64 | Windows | x64 |
| bun-darwin-x64 | macOS | x64 |
| bun-darwin-arm64 | macOS | arm64 |

Output and Artifacts

The output of the `bun build` command includes all imported modules and dependencies bundled into the executable, along with the Bun runtime. This means that the generated binary can run independently of the Bun environment being installed on the target machine[1][3][6].

In summary, the `bun build` command is a powerful tool for developers looking to create efficient and portable applications using Bun, enabling easy deployment across various platforms.