Overview
How the Shape repository is laid out and where to look first.
Shape is a Tauri 2 desktop IDE. The UI is a Next.js app exported as static assets. The Rust backend owns commands, files, Git, the agent, terminals, and language-server adapters.
Bird's-eye view
| Path | Role |
|---|---|
app/ | Routes for the workbench, settings, agent, and popout windows |
features/ | Product surfaces — editor, chat, explorer, Git, terminal, preview/design mode, settings |
lib/ | Shared TypeScript: backend wrappers, settings, auth |
components/ui/ | Shared UI primitives |
src-tauri/ | Rust crate, Tauri config, agent, Git, PTY, LSP |
docs/ | User and contributor MDX |
scripts/ | Preview runtime, Monaco workers, docs index, version sync, release notes |
tests/ | Vitest suites |
Where to go next
- Local development — run and build locally
- Architecture — frontend, shell, and Rust layers
- Tauri IPC — commands and events
- Agent tools — how chat tools are defined and dispatched
- Language servers — LSP lifecycle
- Indexing and search — codebase search
- Client trust — Cloud AI and server-side usage