Role#

The frontend is a React 19 application running inside the Tauri webview. It presents repositories, workspaces, sessions, the composer, file editor, inspector, and settings.

Main areas#

• App shell and navigation for repository and workspace selection.
• Conversation panel for streamed agent output.
• Composer for prompts and rich text input.
• Editor and inspector for reviewing files and changes.
• Settings for account, appearance, agent, and repository configuration.

Data access#

Frontend code calls typed wrappers around Tauri IPC commands. TanStack React Query manages loading, invalidation, and cached UI state.

UI conventions#

Helmor uses Tailwind CSS v4, semantic theme tokens, shadcn-style primitives, and icon-driven controls. Feature code should stay in feature folders instead of growing the root app file.