Files
headquarter/openspec/changes/archive/2026-05-22-add-project-settings-page/design.md
T
alex fb0f2f7b9b feat: add project settings page navigation
- Remove inline edit modal from projects listing page
- Add Settings link to project cards navigating to /projects/:id/settings
- Reposition Open Workspace button to rightmost action for easier access
- Update tests for new UI flow
- Update documentation to reflect new editing workflow
- Sync specs: frontend-foundation and project-management

Quality gates: npm run lint passed
2026-05-22 18:43:40 +00:00

2.4 KiB

Context

The projects listing page (apps/web/src/pages/projects.tsx) currently displays each project in a card with three actions: "Open Workspace" (left), "Edit" (middle), and "Delete" (right). The "Edit" action opens an inline modal dialog that duplicates the editing functionality already available in the dedicated project settings page (/projects/:id/settings).

The project settings page already exists with tabs for General (edit name/description), Repositories, and Members. The add-repo functionality is already located in the Repositories tab.

Goals / Non-Goals

Goals:

  • Simplify the projects listing page by removing the inline edit modal
  • Add a Settings link to project cards for navigation to the settings page
  • Reposition the "Open Workspace" button to the right side for easier access
  • Keep the projects page focused on navigation and creation

Non-Goals:

  • No changes to project settings page functionality (already implemented)
  • No changes to backend APIs
  • No changes to the add-repo flow (already in settings)
  • No changes to workspace or repository pages

Decisions

Decision: Remove Edit modal, link to settings instead

  • Rationale: The settings page already provides a better editing experience with tabs, persistence feedback, and access to repositories/members. Maintaining two edit UIs creates duplication and confusion.
  • Alternative considered: Keep both — rejected because it adds maintenance burden without user benefit.

Decision: Keep Delete on projects listing

  • Rationale: Deleting a project is a high-level action that makes sense from the overview page. Users expect to delete items from a list view.

Decision: Move "Open Workspace" to the right

  • Rationale: Primary actions (navigation to workspace) should be positioned consistently and prominently. Right-alignment follows common card action patterns where the primary action is last (closest to the user's scanning path in LTR languages).
  • Layout order left-to-right: Settings, Delete, Open Workspace

Risks / Trade-offs

  • [Risk] Users accustomed to inline editing may initially miss the edit button
    • Mitigation: Settings link uses a familiar gear icon and is clearly labeled
  • [Risk] Extra click to edit projects
    • Mitigation: Settings page provides richer editing experience worth the extra click

Migration Plan

No migration needed — purely frontend UI change. Existing project data and APIs are unaffected.

Open Questions

None