wasi-sdk-nixos/README.md

wasi-sdk-nixos

WASM LLVM toolchain and WASI sysroot.

Similar to WebAssembly/wasi-sdk, but re-implemented for NixOS.

Goals

• Lean C/C++ toolchain leveraging as much as possible from upstream sources.
• Basic levels of WASI (no threading, no exceptions).

Versioning

Provided are the upstream versions that WebAssembly/wasi-sdk used mid 2024:

• LLVM: 17
• wasi-libc: 21

Future releases may upgrade these upstream versions.

Usage

The default package contains all required dependencies in the following package subdirectories:

• bin: compilers (clang, clang++) and linker (wasm-ld)
• include: libc headers
• include/c++/v1: libcxx headers
• lib: all libc and libcxx static libraries
• lib/wasi: compiler-rt builtins static library
• share/wasi-sysroot: the WASI sysroot

For concrete usage examples, see michaelfranzl/clang-wasm-browser-starterpack.