TPT Helix

TPT Helix is a next-generation, WASM-native web platform — an attempt at a successor to the browser rather than another browser. It is:

• A WASM-native application platform that renders web content without a JavaScript engine in the hot path.
• An AI-accelerated migration system that ports existing web applications to native WASM.
• A capability-secure runtime where applications declare what they need, not what they can take.
• A memory-efficient engine targeting significantly less RAM than Chromium for equivalent workloads.

See spec.txt for the full design document (v0.1) and TODO.md for the phased execution checklist.

Status: early-stage / active development. Phase 0 (Foundation) and much of Phase 1 (Core) from the roadmap are implemented; see TODO.md for what's done vs. outstanding in any given subsystem.

Workspace layout

This is a Rust cargo workspace (resolver 2, edition 2024) with five members under crates/:

Crate	Purpose
helix-runtime	Core engine: HTML/CSS/layout/text/raster/GPU rendering pipeline, QuickJS/Boa legacy-JS fallback, capability broker, wasmtime WASM hosting, content-addressed storage, libp2p/DASH networking.
helix-wit	Generated wit-bindgen host + guest bindings for the network, storage, dom, and media capability interfaces.
helix-guest-example	A wasm32-unknown-unknown guest component exercising the generated guest bindings.
helix-migrate	AI migration pipeline: tree-sitter discovery, pattern transpilers, type inference, optimize/deploy stages, and Eve/Spark orchestration to port JS/TS apps to Rust/WASM.
appfront	egui + taffy native window host for the render surface.

Building and testing

# Build the default workspace members (helix-runtime, helix-wit, helix-migrate)
cargo build

# Run all tests
cargo test

# Build/test a single crate
cargo build -p helix-runtime
cargo test -p helix-runtime <test_name>

# Benchmarks
cargo bench -p helix-runtime --bench layout_bench
cargo bench -p helix-runtime --bench js_bench
cargo bench -p helix-runtime --bench js_engine_compare
cargo bench -p helix-runtime --bench video_bench

# Lint / format check
cargo clippy --all-targets -- -D warnings
cargo fmt --all -- --check

appfront and helix-guest-example are excluded from the default workspace members because appfront needs a GPU/display and helix-guest-example only targets wasm32-unknown-unknown:

# Native windowed host (needs a GPU/display)
cargo run -p appfront --features window

# WASM guest component
cargo build -p helix-guest-example --target wasm32-unknown-unknown

The libp2p cargo feature on helix-runtime is off by default (the default build uses an in-process peer-network simulation of the same DHT/bitswap contract); enable it to pull in the real libp2p Kademlia/bitswap transport:

cargo build -p helix-runtime --features libp2p

On Windows, the QuickJS fallback's build script (rquickjs) needs patch on PATH (Git for Windows ships it under usr/bin).

CI (.github/workflows/ci.yml) builds and tests on Linux/macOS/Windows, lints with clippy + rustfmt, builds the wasm32 guest, reports coverage via cargo-llvm-cov, and packages a Linux x86_64 release binary of appfront.

License

Dual-licensed under either the MIT License or the Apache License, Version 2.0, at your option.