Home > Engineering > Third Party Software > Bare Runtime > Platform Support

Bare Platform Support


Tier 1 — Prebuilds, CI-tested

Failures block CI. Prebuilt binaries provided via npm. The minimum macOS and iOS versions were raised in 1.34.1.

Platform Architectures Minimum Version
Linux arm64, x64 >= 5.15, glibc >= 2.35
Android arm, arm64, ia32, x64 >= 10
macOS arm64, x64 >= 13.0
iOS arm64, x64 (simulator) >= 15.0
Windows x64 >= 10
Windows arm64 >= 11

Tier 2 — Known to work, no CI

Regressions possible between releases.

Platform Architectures Minimum Version
Linux arm64, x64 >= 5.10, musl >= 1.2
Linux arm, ia32 >= 5.10, musl >= 1.2
Linux riscv64 >= 6.8, glibc >= 2.39
Linux riscv64 >= 6.6, musl >= 1.2
Linux mips, mipsel >= 5.10, musl >= 1.2

Building from Source

npm i -g bare-make
npm i
bare-make generate
bare-make build

Output:

Compile options via --define:

The default BARE_ENGINE is github:holepunchto/libjs. The compile options are not covered by semantic versioning. bare-make generate also takes --sanitize.


Embedding (C API)

Bare is designed for embedding. Clean C API via bare.h:

#include <bare.h>
#include <uv.h>

bare_t *bare;
bare_setup(loop, platform, &env, argc, argv,
           options, &bare);
bare_load(bare, filename, source, &module);
bare_run(bare, UV_RUN_DEFAULT);

int exit_code;
bare_teardown(bare, UV_RUN_DEFAULT, &exit_code);

Further functions: bare_poll() for a loop the host owns, bare_attach() / bare_detach() (1.34), bare_context_set() / bare_context_get() for an embedder context (1.33), bare_seal() (1.32), and bare_version(). Static linking needs whole-archive linking.

For mobile apps, Bare’s documentation points to bare-kit (worklets and IPC for iOS and Android) and react-native-bare-kit.

Mobile embedding examples:


Source: github.com/holepunchto/bare