docs: document rust/apps architecture in AGENTS.md

This commit is contained in:
Maze Winther 2026-04-06 00:24:21 +02:00
parent 44d8c4c876
commit e62227914a
1 changed files with 11 additions and 5 deletions

View File

@ -1,13 +1,19 @@
# Agents.md
## Apps
## Architecture
- Web
- Desktop
An ongoing migration is moving all business logic into `rust/`. Each app under `apps/` is a UI shell — it owns rendering, interaction, and platform-specific concerns, but never owns logic. The UI framework for any given app is a replaceable detail.
## Rust
### `rust/`
Shared code between apps live in `rust/`, not in `packages/`
The single source of truth for all non-UI code. Everything platform-agnostic belongs here: no components, no hooks, no framework imports.
### `apps/`
Each app is a frontend that calls into Rust. Logic is never duplicated between apps — only UI is, because each platform may use an entirely different framework and language to build it.
- `web/` — Next.js
- `desktop/` — GPUI
## Web