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:
build/bin/bare(.exe)build/libbare.(a|lib)build/(lib)bare.(dylib|dll|lib)
Compile options via --define:
BARE_ENGINE— JS engine (default: libjs)BARE_PREBUILDS— enable prebuilds (default: ON)BARE_MEMORY_LIMIT— JS heap limit (default: 0, unlimited)BARE_ENGINE_SHARED— link the engine as a shared library (default: OFF; 1.35)
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