Argui is a retained Rust UI engine with Solid and React TSX adapters. The desktop TSX host embeds QuickJS; the Web host runs the same Rust renderer in WebAssembly on a WebGPU canvas. Rust applications can use the runtime directly. These guides document the current 0.4 source and its platform limits. Application commands run from a generated project; contributor commands name the repository root explicitly.
- Getting started: prerequisites, CLI projects, native and browser runs, and the checked-in Rust and TSX templates.
- Argui CLI: 0.4 installation, every application command, build targets, tests, and component installation.
- Crates and features: which Rust dependencies to add and how optional Cargo features affect an application.
- Architecture: ownership, reconciliation, invalidation, rendering, and platform boundaries.
- Solid and React host contract: the transaction bridge, identity, state, and browser versus desktop capabilities.
- Gallery: runnable Solid and React controls.
| Need | Guide |
|---|---|
| Custom components and reactive state | Custom components and state |
| Sizing, flex, grid, RTL | Layout |
| Native scrolling and virtualization | Scrolling |
| Paint, borders, shadows, colors | Styling |
| Transitions, loops, and frame cost | Animation |
| Widget exports and state contracts | UI and widgets |
| Focus, events, input, semantics | Interaction · Accessibility |
| Theme runtime and tokens | Theme |
| Application assets | Icons and media |
Start with desktop windows for monitors, logical and physical coordinates, zoom, resizing, movement, decorations, transparency, input regions, native popups, and backend limits. Then use the focused guides:
- Application setup and safe areas
- Desktop backdrops and popups beyond the window
- File picker, WebView, and updater
- Android and iOS boundary
- Models and lifetime and owned tasks
- Rendering primitives, text, damage, compositor, effects, and GPU canvases
- Internationalization and native automation
- Repository structure, development, code quality, Linux graphical testing, and releases
The current API is defined by the Rust schema and the generated Solid and React JSX declarations.