Desktop App
The Monday Morning desktop app is a native application built with Tauri 2.x and Svelte 5 (using Runes). It provides a visual interface for managing specs, tasks, issues, and meetings across all your projects.
Architecture
Section titled “Architecture”The app uses a two-process architecture:
- Rust backend (Tauri) — File system access, secure credential storage, process management, and system integration.
- Svelte frontend — Reactive UI rendered in a native webview, communicating with the backend via Tauri commands.
Project data lives in .mm/ directories inside your repositories. The desktop app reads and writes these files directly — there is no separate database or server process.
Main UI Areas
Section titled “Main UI Areas”Sidebar
Section titled “Sidebar”The left sidebar is the primary navigation. It contains:
| Item | Description |
|---|---|
| Kanban | Board view of specs, tasks, and issues |
| Docs | Browse and edit project documents |
| Meetings | View synced meeting notes (via Grain plugin) |
| Health | Project health check dashboard |
| Plugins | Manage installed plugins (bottom section) |
| Settings | App and project configuration (bottom section) |
| What’s New | Changelog for recent updates |
The sidebar can be collapsed to icon-only mode using the toggle button in the brand area, or with Cmd+B / Ctrl+B.
Plugins can register additional sidebar items. For example, a Grain plugin might add a “Meetings” tab that only appears when the plugin is configured.
Kanban Board
Section titled “Kanban Board”The default view is a kanban board that groups entities (specs, tasks, issues) into columns by status. You can:
- Drag cards between columns to update status
- Click a card to open its detail panel
- Reorder columns and cards
- Sort columns by different criteria
- Hide columns you do not need
In the backlog column, features grouped under the same wave are separated by a header showing Wave N — Label. Waves containing more than one feature display a Parallel badge, signalling that those features have no dependencies on each other and can be implemented concurrently. See Wave sequencing in the specs workflow docs for details.
Project Selector
Section titled “Project Selector”The top area includes a project selector dropdown. Choose a specific project to scope the board and all views to that project, or select “All Projects” to see everything.
Detail Panel
Section titled “Detail Panel”Clicking a card opens a slide-out detail panel on the right side. The panel shows:
- Entity title and metadata
- Full markdown content
- Task checklists (for specs with implementation.md)
- Related entities and links
- Activity stream
Claude Terminal Panel
Section titled “Claude Terminal Panel”A docked panel at the bottom provides an integrated Claude Code terminal. Toggle it with Cmd+\`` / `` Ctrl+ “. You can:
- Start new AI conversations
- Run Monday Morning commands (
/mm:spec,/mm:task, etc.) - Undock the panel into a separate window with
Cmd+Shift+C/Ctrl+Shift+C
Documents View
Section titled “Documents View”The Docs tab provides a list view of all markdown documents across your project. Documents are rendered with full markdown support and can be edited inline.
Health Dashboard
Section titled “Health Dashboard”The Health view runs automated checks on your project structure and flags issues like:
- Specs missing
implementation.md - Stale tasks that have not been updated
- Orphaned files not linked from any dashboard
App Modes
Section titled “App Modes”Monday Morning supports two modes:
| Mode | Purpose |
|---|---|
| Developer | Full feature set: specs, tasks, kanban, terminal |
| PM | Simplified view focused on meetings and reports |
Switch between modes in Settings.
Themes
Section titled “Themes”The app supports three theme options:
- Dark (default) — Dark background with light text
- Light — Light background with dark text
- System — Follows your OS preference
Toggle between light and dark with Cmd+T / Ctrl+T, or set the theme in Settings.
Plugin UI Contributions
Section titled “Plugin UI Contributions”Plugins can extend the desktop UI declaratively through the ui property on MondayMorningPlugin. The app renders these contributions uniformly:
- Card badges — Icons or labels on kanban cards (e.g., GitHub PR status)
- Sidebar items — Additional navigation tabs
- Dashboard widgets — Summary cards and mini-lists
- Actions — Command palette and context menu items
See Plugin Architecture for details on declaring UI contributions.
Next Steps
Section titled “Next Steps”- Settings — Configure the desktop app and project settings.
- Keyboard Shortcuts — Full shortcut reference.
- Installation — Install the CLI and desktop app.