545cb546cc
* Skeleton code for `bun run --workspace` * Update run_command.zig * implement directory traversal to find workspace root * finish --workspace implementation * clean up changes in run_command.zig * add workspace tests, update harness to handle nested dirs * [autofix.ci] apply automated fixes * basic filtering * [autofix.ci] apply automated fixes * working filter without patterns * update tests, filter mostly working * simplify package name parsing, commit tests * support filter even without workspace setup * move filter arg handling to separate source file * use bun.sys.chdir, match root package for scripts * fix exit code handling * ignore node_modules and directories starting with . in --filter * progress converting --filter to use iterators * convert filtering to use iterators * cleanup * implement DirEntry access method for glob (currently crashing) * cleanup and fixes * run js files in subprocess when filter flag passed * clean up dead code * fix fd leak in run_command.zig * [autofix.ci] apply automated fixes * fix issues after merge * use posix-spawn in runBinary, fix resource PATH variable resource leak * move filter argument to runtime category * fix test harness * add js and binary tests to filter-workspace * [autofix.ci] apply automated fixes * fix compile after merge * [autofix.ci] apply automated fixes * clean up filter-workspace test * [autofix.ci] apply automated fixes * fixes to running binaries * fix actually setting cwd_override * windows fixes * address some review comments * handle malformed JSON * add various tests * [autofix.ci] apply automated fixes * update docs for filter * [autofix.ci] apply automated fixes * reset tinycc commit * filtered run prototype * make pretty * implement abort handler (not working) * make prettier * prep for windows * windows path and printing fixes * implement log-style output (not tui) * fix issues when logging to file * revert a bunch of unecessary changes * cleanup * implement dependency order execution * detect circular dependencies, fix cancel hang * Fix `$PATH` * ignore dep order on loop, stream on linux, sort pkgs * support pre and post scripts * add more filter tests, print elapsed time * enable 'bun --filter' without run * fix harness after merge * [autofix.ci] apply automated fixes * print number of scripts we're waiting for * update docs, fix windows build * fix tests on windows * [autofix.ci] apply automated fixes * fix uninitialized memory * use terminal synchronized update sequences * Add skip list * Preallocate * Use current bun in tests --------- Co-authored-by: Jarred Sumner <709451+Jarred-Sumner@users.noreply.github.com> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Jarred Sumner <jarred@jarredsumner.com>
Bun
Read the docs →
What is Bun?
Bun is under active development. Use it to speed up your development workflows or run simpler production code in resource-constrained environments like serverless functions. We're working on more complete Node.js compatibility and integration with existing frameworks. Join the Discord and watch the GitHub repository to keep tabs on future releases.
Bun is an all-in-one toolkit for JavaScript and TypeScript apps. It ships as a single executable called bun.
At its core is the Bun runtime, a fast JavaScript runtime designed as a drop-in replacement for Node.js. It's written in Zig and powered by JavaScriptCore under the hood, dramatically reducing startup times and memory usage.
bun run index.tsx # TS and JSX supported out-of-the-box
The bun command-line tool also implements a test runner, script runner, and Node.js-compatible package manager. Instead of 1,000 node_modules for development, you only need bun. Bun's built-in tools are significantly faster than existing options and usable in existing Node.js projects with little to no changes.
bun test # run tests
bun run start # run the `start` script in `package.json`
bun install <pkg> # install a package
bunx cowsay 'Hello, world!' # execute a package
Install
Bun supports Linux (x64 & arm64), macOS (x64 & Apple Silicon) and Windows (x64).
Linux users — Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1.
# with install script (recommended)
curl -fsSL https://bun.sh/install | bash
# on windows
powershell -c "irm bun.sh/install.ps1 | iex"
# with npm
npm install -g bun
# with Homebrew
brew tap oven-sh/bun
brew install bun
# with Docker
docker pull oven/bun
docker run --rm --init --ulimit memlock=-1:-1 oven/bun
Upgrade
To upgrade to the latest version of Bun, run:
bun upgrade
Bun automatically releases a canary build on every commit to main. To upgrade to the latest canary build, run:
bun upgrade --canary
Quick links
- Intro
- CLI
- Runtime
- Ecosystem
- API
Contributing
Refer to the Project > Contributing guide to start contributing to Bun.
License
Refer to the Project > License page for information about Bun's licensing.