Getting started with ZeroWebView and ZeroBrowser
Prepare a local checkout, launch the desktop browser and inspect the WebView API before embedding the experimental engine.
Check prerequisites
- Rust 1.85 or newer, with edition 2024 support.
- Git, GNU Make and the platform build tools. Development and comparison scripts use Node.js 20 or newer.
- macOS: Xcode Command Line Tools. Linux: install the desktop libraries listed in the development guide. Windows: use MSVC Build Tools and the documented libclang setup.
The commands below use the Linux/macOS entrypoints. Windows users should follow the linked Windows guide and its PowerShell scripts.
Prepare the repository
git clone https://github.com/leizongmin/ZeroWeb.git
cd ZeroWeb
make setup-rusty-v8The setup command downloads the V8 archive matching the checked-out dependency version and Rust host target. It needs access to the release download; if it fails, inspect the target and download diagnostics before continuing.
Launch a real browser window
This entrypoint builds the browser and its companion process binaries, then opens a desktop browser window:
make browserFirst-run compilation can take time. A build error means the window has not been launched; check platform prerequisites and V8 setup first. Successfully opening a window does not establish real-site compatibility or production readiness.
Inspect the smaller demo
cargo run --bin webview-demoExpect a host window with static text rendered through the project's graphics infrastructure. This is not a complete example of every ZeroWebView page API. For embedding, inspect the public API and current configuration types in the WebView crate; the API surface is still evolving.
Plan host integration
Keep page capabilities behind the WebView API rather than coupling your application directly to layout or paint internals. Decide which script features and rendering backend your host needs, and validate navigation, input and lifecycle behavior in that actual configuration.
Sources: Linux/macOS setup, Windows setup, embedding API, demo source.
Engineering guides
How ZeroWeb tests AI-autonomous software engineering
A browser gives AI development a long-running test case: architecture, code, debugging and verification must work together.
ZeroWeb Rust browser architecture: from request to pixels
Follow the page pipeline and the boundaries between the browser application, embeddable WebView, engine and rendering infrastructure.
How to read ZeroWeb WPT and performance results
Understand self-source reftests, assertion-based suites, changing corpus sizes and p95 benchmarks before comparing results.