pulseengine/rules_wasm_component

Bazel rules for WebAssembly Component Model development with multi-profile builds and dependency management

Bazel Rules for WebAssembly Component Model

Modern Bazel rules for building WebAssembly components across multiple languages.

Why Use This?

• Multi-language: Build components from Rust, Go, C++, JavaScript
• Production Ready: OCI publishing, signing, composition, optimization
• Bazel Native: Hermetic builds, caching, cross-platform support

Installation

Add to your MODULE.bazel:

bazel_dep(name = "rules_wasm_component", version = "1.0.0")

Quick Example

# Build a component from Rust
rust_wasm_component_bindgen(
    name = "hello_component",
    srcs = ["src/lib.rs"],
    wit = ":hello_interfaces",
)

Documentation

📚 Complete Documentation →

• Zero to Component in 2 Minutes - Fastest way to get started
• Language Guides - Rust, Go, C++, JavaScript tutorials
• Production Deployment - OCI publishing, signing, optimization
• Examples - Working examples from basic to advanced

Known Limitations

Go WIT Components (Temporary)

• Issue: WIT-enabled Go components currently fail due to upstream TinyGo limitations
• Tracking: GitHub Issue #82
• Status: Excluded from CI until TinyGo PR #4934 lands
• Workaround: Basic Go components (without WIT) work perfectly

C++ Exception Handling

• Design: WASI disables C++ exceptions by default for size/performance
• Solution: Components use error codes instead of exceptions (Issue #83)
• Override: Use enable_exceptions = True for components that require exceptions

Contributing

Contributions welcome! See CONTRIBUTING.md for details.

License

Apache 2.0 - See LICENSE for details.