32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# Development
|
||
|
||
> **Status:** draft · **Last updated:** 2026-10-13
|
||
|
||
## Prerequisites
|
||
|
||
- Rust stable (via rustup), edition 2024
|
||
- Node.js 20 or newer and pnpm
|
||
- 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 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-13 | major | Initial draft |
|