Files
headquarter/openspec/changes/ui-redesign-home-settings/proposal.md
T
2026-06-03 08:51:02 +00:00

1.3 KiB

UI Redesign: Home + Settings

Problem

The current authenticated UI is functional but fragmented. Sessions, tool setup, and settings are spread across top-level pages, and the home screen does not yet provide a strong overview of open sessions and available projects.

Solution

Redesign the authenticated frontend around two primary surfaces:

  1. Home: an overview of open sessions and available projects
  2. Settings: a tabbed settings hub with General, SSH Keys, Tool Types, and Tool Configs

Keep existing functionality and the Project -> Repository -> Session hierarchy intact. Reuse the current APIs and workflows.

Scope

  • Redesign the main landing page into an operational overview
  • Fold the Sessions page into the home experience
  • Convert SSH Keys, Tool Types, and Tool Configs into settings tabs
  • Update navigation and routes to match the new IA
  • Refresh visual design, typography, and spacing

Non-Goals

  • No backend behavior changes
  • No new session or project APIs
  • No changes to the project/repository/session data model

Success Criteria

  • Home shows open sessions and available projects clearly
  • Settings contains tabs for General, SSH Keys, Tool Types, Tool Configs
  • Old top-level settings-related routes redirect to the new structure
  • Visual system uses Inter and a refined warm palette