The window is built in setup with the theme tokens injected by an initialization script and the background colour taken from the theme, so the first frame is already themed. Frontend IPC (engine_execute, engine_list_commands) and the control channel both run commands through the Host, which applies effects such as Quit. ui.screenshot captures the window's client area from the screen because xcap skips windows of its own process. build.rs generates the placeholder icon into the gitignored icons/ directory. Verified on Windows: window opens, ping, listCommands, screenshot, app.quit, and exit status 1 when the control port is taken. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# Development
|
||
|
||
> **Status:** draft · **Last updated:** 2026-10-14
|
||
|
||
## Prerequisites
|
||
|
||
- Rust stable (via rustup), edition 2024
|
||
- Node.js 22.12 or newer (Vite 8 needs it) and pnpm 10
|
||
- Tauri 2 system prerequisites for your platform (WebView2 on Windows, WebKitGTK on Linux)
|
||
- Optional: Phpactor on the PATH for language features, PHP 8.2+ and Composer for reference projects
|
||
|
||
## Everyday commands
|
||
|
||
```sh
|
||
cargo xtask dev # run the app in development mode
|
||
cargo xtask dev -- --control 7979 . # with the JSON control channel
|
||
cargo xtask ci # the full quality gate, run before every commit
|
||
cargo xtask fixtures # create Symfony and Laravel reference projects in target/fixtures/
|
||
```
|
||
|
||
## Robustness: Lutra never crashes
|
||
|
||
Shipped code returns errors instead of panicking (see AGENTS.md › Never crash). The engine guard catches panics at every entry point, keeps buffers intact and reports an internal error. Unsaved buffers are journaled so a restart can restore them.
|
||
|
||
## Code style
|
||
|
||
No inline comments. Doc comment blocks above modules, functions, types and fields explain purpose, parameters, return values and errors.
|
||
|
||
## Revision history
|
||
|
||
| Date | Change | Summary |
|
||
|---|---|---|
|
||
| 2026-10-14 | minor | Node.js 22.12+ required by the frontend toolchain |
|
||
| 2026-10-13 | major | Initial draft |
|