Pentimento
Stand-alone native and WASM 3D GPU Rendering With Svelte or Dioxus UI in Bevy
Pentimento
Pentimento is a multi-frontend Bevy workspace with a shared frontend/backend contract across supported CEF, Electron, and Dioxus frontends plus an experimental native egui implementation.
Canonical Workflow
Use the root launcher for install, build, run, and verification:
./launcher.sh --help
./launcher.sh --install
./launcher.sh --build --frontend cef
./launcher.sh --build --frontend egui
./launcher.sh --build-release --frontend electron
./launcher.sh --run --frontend dioxus
./launcher.sh --run --frontend egui
./launcher.sh --test
Frontend Paths
| Frontend | Ownership Model | Status |
|---|---|---|
cef |
Native Bevy app + Chromium offscreen webview | Active |
electron |
Electron shell + Svelte UI + Bevy WASM | Active |
dioxus |
Native Bevy app + Rust-native Dioxus UI | Active |
egui |
Native Bevy app + bevy_egui overlay UI |
Experimental |
Discontinued paths such as capture, overlay, and Tauri remain in the repository for historical context only and are not part of the canonical standards-aligned workflow.
Support Matrix
| Platform | Status | Notes |
|---|---|---|
| Linux x86_64 | Required | Canonical CI and launcher verification target. |
| Windows x86_64 | Unsupported | crates/webview/src/platform_windows.rs is still a stub. |
| macOS ARM / Intel | Unsupported | No active verification path today. |
The support decision, experimental egui status, and IPC ownership model are recorded in ADR-001.
System Requirements
Linux packages
sudo apt-get install -y \
libasound2-dev \
libgtk-3-dev \
libudev-dev \
libwayland-dev \
libxkbcommon-dev \
pkg-config
Tooling
rustup target add wasm32-unknown-unknown
cargo install wasm-bindgen-cli
Node.js 22+ is required for the Svelte and Electron tooling.
Verification
./launcher.sh --test is the canonical local verification command. It currently enforces:
- active source-directory README coverage
- active frontend Rust formatting
- Svelte accessibility linting
- TypeScript typechecking for the browser and Electron shells
- Rust-to-JavaScript IPC acceptance coverage
- warning-free cargo checks for the CEF, Dioxus, egui, WASM, and shared native UI crates
Project Structure
crates/app/ Native Bevy application entrypoint
crates/app-wasm/ Electron/WASM Bevy entrypoint
crates/dioxus-ui/ Native Rust UI implementation
crates/egui-ui/ Experimental native egui UI implementation
crates/frontend-core/ Shared native frontend snapshot and contract helpers
crates/ipc/ Shared frontend/backend message contract
crates/webview/ Platform host integrations for CEF and Dioxus
src-electron/ Electron shell compiled from TypeScript
ui/ Svelte frontend
docs/adr/ Recorded architecture decisions
License
MIT
