- 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
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