Guides

These guides take you from the integration-layer mental model to a clean Web application with a small Rust/WASM island. They assume that the existing Web renderer remains the host application and that Vooya owns only the bounded capability you explicitly mount. Vue and React are the current supported first-party paths. Solid and Svelte are experimental and currently covered on the Vite 7 Rust-file path; the layer can support other hosts only through explicit adapters and independent evidence.

Mental model first

The host framework owns the page tree, router, business state, and the host element. Vooya mounts one Rust-owned island below that element and keeps the boundary explicit through props, events, lifecycle, and disposal. Start with the component boundary if you are unsure whether a feature belongs in Rust, or read why Vooya for the problem this layer is intended to solve.

Choose a path

Goal	Start here
Run a first component	Getting started
Understand the Rust source contract	Rust-file authoring
Review unreleased features	Next release
Choose a bundler	Bundler guide
Add a canvas-heavy example	Scatter plot
Use another bundler	Tooling reference and the compatibility matrix
Diagnose a failed local build	Troubleshooting and the FAQ

The short version

1. Install the host framework adapter and the bundler integration.
2. Install Rust, the wasm32-unknown-unknown target, and the pinned wasm-bindgen-cli.
3. Add vooya() to the Vite host build.
4. Author an ordinary .rs component or store.
5. Run vooya doctor before the first development build.

Vooya is currently a beta source-authoring toolchain. A clean consumer still needs the Rust toolchain; a supported precompiled component distribution is a future product, not an implicit feature of this package set. The current supported first-party framework adapters are Vue and React. Solid and Svelte are experimental first-party adapters; other host renderers remain an adapter and evidence task.