Skip to main content

Release v0.2.5 - Tauri Desktop UX Improvements

Release Date: 2026-03-15
Tag: v0.2.5
Fitness Score: 100% ✅

Overview​

This release focuses on improving the Tauri desktop application user experience with enhanced menu navigation, keyboard shortcuts, and fixing critical lifecycle issues in the Kanban workflow.

🎯 Key Highlights​

1. Enhanced Desktop Menu System​

New Navigate Menu with keyboard shortcuts:

  • Dashboard (Cmd+1 / Ctrl+1)
  • Kanban Board (Cmd+2 / Ctrl+2)
  • Agent Traces (Cmd+3 / Ctrl+3)
  • Settings (Cmd+, / Ctrl+,)

Tool Mode Toggle moved to View menu:

  • Toggle between Essential (7 tools) and Full (34 tools) mode
  • Keyboard shortcut: Cmd+Shift+T / Ctrl+Shift+T
  • Accessible from any page, not just session pages

Improved Menu Structure:

File
├── Reload (Cmd+R)
└── Quit (Cmd+Q)

View
├── Toggle Developer Tools (Cmd+Option+I)
└── Toggle Tool Mode (Essential/Full) (Cmd+Shift+T)  ← NEW

Navigate  ← NEW MENU
├── Dashboard (Cmd+1)
├── Kanban Board (Cmd+2)
├── Agent Traces (Cmd+3)
└── Settings (Cmd+,)

Tools
├── Install Agents... (Cmd+Shift+I)
└── MCP Tools (Cmd+Shift+M)

2. Fixed Kanban Repository Lifecycle​

Problem: Users encountered a broken navigation loop when trying to add repositories from Kanban page.

Solution: Replaced broken "Add in Settings" link with inline RepoPicker component.

Benefits:

  • ✅ No page navigation required
  • ✅ Clone/select repos directly from Kanban
  • ✅ Auto-refreshes after successful add
  • ✅ Consistent with HomeInput UX pattern

3. Tauri Static Route Handling​

Fixed routing for non-workspace pages in Tauri desktop app:

  • /traces → Agent Trace Viewer
  • /mcp-tools → MCP Tools page
  • /settings → Settings page

All static pages now load correctly without falling back to homepage.

📊 Technical Details​

Modified Files​

  • apps/desktop/src-tauri/src/lib.rs - Menu system enhancements
  • crates/routa-server/src/lib.rs - Static route handling
  • src/app/workspace/[workspaceId]/kanban/kanban-tab.tsx - Inline RepoPicker
  • package.json - Version bump to 0.2.5
  • apps/desktop/src-tauri/tauri.conf.json - Version bump to 0.2.5

Commits in This Release​

  1. b1db72c - chore: bump version to 0.2.5
  2. 2a1b788 - fix(kanban): add inline RepoPicker for empty repository state
  3. eac6323 - feat(tauri): add system menu for tool mode and navigation
  4. 6bb1a64 - fix(tauri): add static route handling for non-workspace pages
  5. c5eaf21 - docs(agents): add Tauri routing debug tip
  6. 63d6a57 - fix(tauri): add kanban route mapping to Rust backend

Fitness Score: 100%​

All fitness checks passing:

  • ✅ EVOLVABILITY: 100%
  • ✅ MAINTAINABILITY (Code Quality): 100%
  • ✅ MAINTAINABILITY (Rust API Test): 100%
  • ✅ SECURITY: 100%
  • ✅ TESTABILITY: 100%

🚀 Upgrade Instructions​

For Users​

  1. Download the new DMG (macOS):

    # Build from source
    cd apps/desktop
    npm run build

  2. Install the DMG:

    • Open target/release/bundle/dmg/Routa Desktop_0.2.5_aarch64.dmg
    • Drag to Applications folder

  3. Enjoy new features:

    • Try keyboard shortcuts: Cmd+1, Cmd+2, Cmd+3
    • Toggle Tool Mode: Cmd+Shift+T
    • Add repos directly from Kanban page

For Developers​

  1. Pull latest changes:

    git pull origin main
    git checkout v0.2.5

  2. Install dependencies:

    npm install

  3. Run in development:

    cd apps/desktop
    npm run tauri dev

📝 Documentation​

🙏 Acknowledgments​

This release was developed with assistance from:

  • Augment Agent (Claude Sonnet 4.5)

📦 Assets​

  • macOS (Apple Silicon): Routa Desktop_0.2.5_aarch64.dmg
  • macOS App: Routa Desktop.app

🔗 Links​

Full Changelog: v0.2.4...v0.2.5