Lava is an experimental Bun-inspired JavaScript runtime and toolkit written in Odin. The runtime target is JavaScriptCore (JSC).
This repository is initialized with a small Odin CLI and the first package
boundaries for the runtime, package manager, bundler, and JSC integration.
Compatibility targets modern Node.js 26+ behavior (floor pinned in .nvmrc) rather than legacy Node APIs.
- Odin (CI pins
dev-2026-11awith LLVM 18) - JavaScriptCore development headers and libraries
- SQLite development headers and libraries (for
node:sqlite) - OpenSSL development headers and libraries (for
fetchHTTPS/TLS)
On Linux, the JSC package is exposed through pkg-config as javascriptcoregtk-6.0,
SQLite as sqlite3, and OpenSSL as openssl
(e.g. apt-get install libjavascriptcoregtk-6.0-dev libsqlite3-dev libssl-dev).
On macOS, JSC is provided by the JavaScriptCore framework and SQLite by the
system libsqlite3; OpenSSL comes from Homebrew (brew install openssl@3) and
scripts/build.sh adds its keg-only lib path to the link line.
On Windows, Lava keeps third-party native payloads out of git. Run
make bootstrap-windows-deps (or bash scripts/bootstrap-windows-deps.sh) to
fetch JavaScriptCore/WebKit and the SQLite amalgamation into the ignored .deps/
cache. scripts/build-sqlite-windows.sh then compiles SQLite into
build/sqlite3.lib; WebKit is linked from .deps/webkit/bun-webkit/lib.
Node 26+ (26.13.0 pinned in .nvmrc; oracle suites refuse an older major) and Bun are needed for the JavaScript gates — run bun install once.
They are dev-only (markdownlint-cli2, acorn/acorn-walk for the
prototype-pollution ratchet, fast-check for make test-property); bin/lava
links none of them. make check-js is an always-gate and now fails without them.
make buildRun it:
make eval SOURCE="console.log('hello from Lava')"
make run FILE=app.jsUseful project commands:
make help
make bootstrap-windows-deps
make check
make check-jsc
make check-native
make test
make test-lava
make test-sqlite-node
make test-sqlite-lavacmd/lava- command line entry pointpkg/runtime- JavaScript runtime orchestrationpkg/runtime/eventloop- native event-loop abstraction using io_uring/epoll on Linuxpkg/jsc- JavaScriptCore foreign declarationspkg/std/sqlite- first modern standard-library targetpkg/bundler- future bundling/transpilation workpkg/install- future package install and lockfile workscripts- project helper scripts
See docs/ARCHITECTURE.md for how the pieces fit
together (engine FFI, event loop, module system, the native + embedded-JS
standard library), a review of risks and inconsistencies, and the forward-looking
roadmap toward a best-in-class runtime.
- Link JSC and evaluate source through
JSEvaluateScript. - Add module loading and a small CommonJS/ESM compatibility layer.
- Implement
lava run <file>. - Add package install, lockfile, and cache primitives.
- Add bundling and TypeScript/JSX transform support.