00f27fbeec
* Get bunx tests to pass on Windows * wip * WIP * wip * wip * ads * asdf * makeOpenPath * almost revert * fix build * enoent * fix bun install git repos * cleanup * use custom zig stdlib from submodule * update dockerfile to copy zig stdlib sources * fix dockerfile, update gitmodules * fix dockerfile * fix build * fix build * fix symlinkat * fix build * fix build * Remove usages of unreachable * Fixup * Fixup * wip * fixup * Fix one of the bugs * asd * Normalize BUN_INSTALL_CACHE_DIR var * Set iterable to false when we're about to delete * Update bun.zig * I still can't repro this outside CI * i think that fixes it? * fix posix compile * factor out directory creation * update all install methods to use InstallDirState * move walker creation to init function * fix error cleanup * fix posix compile * all install tests pass locally * cleanup * [autofix.ci] apply automated fixes * Fix posix regressions --------- Co-authored-by: Dylan Conway <dylan.conway567@gmail.com> Co-authored-by: Meghan Denny <hello@nektro.net> Co-authored-by: Georgijs Vilums <georgijs.vilums@gmail.com> Co-authored-by: Georgijs <48869301+gvilums@users.noreply.github.com> Co-authored-by: Georgijs Vilums <georgijs@bun.sh> 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>
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.