Try it before installing
Run the counter in your browser. Click its button and watch the count change. The source beside it is the component used by the hosted build.
Run a component locally
You need Git, rustup, a native C/C++ linker and a working graphics driver. These examples use the framework revision named at the foot of this page, whose toolchain file selects Rust 1.99.1. The crates are not yet published, so start from source:
git clone https://github.com/tomyan/vapors.git
cd vapors
git checkout 40f410f75b03cc07c8733b2c330b67d75a3c881b
cargo run -p vapors-app --example demo -- counter Cargo builds the component and opens a native window. Click the button: the count increases and the strip below it turns green.
On Debian/Ubuntu, the framework’s Linux build environment includes these native development libraries:
sudo apt-get install build-essential pkg-config libfontconfig1-dev libxkbcommon-dev libxkbcommon-x11-dev libwayland-dev libx11-dev libxcursor-dev libxrandr-dev libxi-dev Use the appropriate GPU driver for your system. The package command supplies build dependencies; it does not install or configure every graphics driver. Other operating systems need their native compiler/linker toolchain.
Make a visible change
Open crates/demos/demos/counter.wisp. Change the button text from “Clicked” to “Pressed”, then close the demo window and run the same Cargo command again. The rebuilt window should show your new text.
Next, change the increment handler from *n += 1 to *n += 2, rebuild and click. The count should advance by two. There is no hot reload at this revision.
The course starts with a smaller component and adds signals, derived state, CSS, inputs and child components. Its custom examples replace a named demo file so you can use the existing app host.
Run another example
Use a demo name such as hello, field, checkbox, number, slider, scroll or cards:
cargo run -p vapors-app --example demo -- cards The examples page pairs hosted demos with their source. Elements and events is the support reference for this revision.
Build for the browser
The browser build uses the repository’s pinned Trunk and wasm-bindgen tools. cargo xtask setup installs the pinned development tools and a local pre-push hook; run it in your own checkout:
cargo xtask setup
cargo xtask web Serve target/web over HTTPS or localhost. Add ?demo=counter to open the counter. Running in the browser explains WebGPU requirements and embedding.
Check syntax without opening a window
cargo run -p vapors-compiler --bin wisp-check -- crates/demos/demos/counter.wisp Exit status 0 means parsing and code generation succeeded. A refusal returns a nonzero exit code with a source location. This does not replace Rust type checking or running the component to check its layout and CSS.
For a new application, Component files explains build integration; the framework’s demos show the native and web hosts. Native mobile hosting is coming soon.