Single-file executable

./mycli

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

# To support CPUs from before 2013, use the baseline version (nehalem)
bun build --compile --target=bun-linux-x64-baseline ./index.ts --outfile myapp

# To explicitly only support CPUs from 2013 and later, use the modern version (haswell)
# modern is faster, but baseline is more compatible.
bun build --compile --target=bun-linux-x64-modern ./index.ts --outfile myapp

# Note: the default architecture is x64 if no architecture is specified.
bun build --compile --target=bun-linux-arm64 ./index.ts --outfile myapp

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

# To support CPUs from before 2013, use the baseline version (nehalem)
bun build --compile --target=bun-windows-x64-baseline ./path/to/my/app.ts --outfile myapp

# To explicitly only support CPUs from 2013 and later, use the modern version (haswell)
bun build --compile --target=bun-windows-x64-modern ./path/to/my/app.ts --outfile myapp

# note: if no .exe extension is provided, Bun will automatically add it for Windows executables

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

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

bun build --compile --define BUILD_VERSION='"1.2.3"' --define BUILD_TIME='"2024-01-15T10:30:00Z"' src/cli.ts --outfile mycli

bun build --compile --minify --sourcemap ./path/to/my/app.ts --outfile myapp

bun build --compile --minify --sourcemap --bytecode ./path/to/my/app.ts --outfile myapp

bun build --compile --compile-exec-argv="--smol --user-agent=MyBot" ./app.ts --outfile myapp

// In the compiled app
console.log(process.execArgv); // ["--smol", "--user-agent=MyBot"]

echo "console.log(\"you shouldn't see this\");" > such-bun.js
bun build --compile ./such-bun.js

# Executable runs its own entrypoint by default
./such-bun install

# With the env var, the executable acts like the `bun` CLI
bun_BE_BUN=1 ./such-bun install

bun build --compile ./server.ts --outfile myapp

./myapp

bun build --compile ./index.ts ./my-worker.ts --outfile myapp

console.log("Hello from Bun!");

// Any of these will work:
new Worker("./my-worker.ts");
new Worker(new URL("./my-worker.ts", import.meta.url));
new Worker(new URL("./my-worker.ts", import.meta.url).href);

import db from "./my.db" with { type: "sqlite" };

console.log(db.query("select * from users LIMIT 1").get());

cd /home/me/Desktop
./hello

// this becomes an internal file path
import icon from "./icon.png" with { type: "file" };
import { file } from "bun";

export default {
	fetch(req) {
		// Embedded files can be streamed from Response objects
		return new Response(file(icon));
	},
};

import icon from "./icon.png" with { type: "file" };
import { file } from "bun";

const bytes = await file(icon).arrayBuffer();
// await fs.promises.readFile(icon)
// fs.readFileSync(icon)

import myEmbeddedDb from "./my.db" with { type: "sqlite", embed: "true" };

console.log(myEmbeddedDb.query("select * from users LIMIT 1").get());

const addon = require("./addon.node");

console.log(addon.hello());

bun build --compile ./index.ts ./public/**/*.png

import icon from "./public/assets/icon.png" with { type: "file" };
import { file } from "bun";

export default {
	fetch(req) {
		// Embedded files can be streamed from Response objects
		return new Response(file(icon));
	},
};

import "./icon.png" with { type: "file" };
import { embeddedFiles } from "bun";

console.log(embeddedFiles[0].name); // `icon-${hash}.png`

bun build --compile --asset-naming="[name].[ext]" ./index.ts

codesign --deep --force -vvvv --sign "XXXXXXXXXX" ./myapp

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.security.cs.allow-jit</key>
    <true/>
    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
    <true/>
    <key>com.apple.security.cs.disable-executable-page-protection</key>
    <true/>
    <key>com.apple.security.cs.allow-dyld-environment-variables</key>
    <true/>
    <key>com.apple.security.cs.disable-library-validation</key>
    <true/>
</dict>
</plist>

codesign --deep --force -vvvv --sign "XXXXXXXXXX" --entitlements entitlements.plist ./myapp

codesign -vvv --verify ./myapp
./myapp: valid on disk
./myapp: satisfies its Designated Requirement