Developer
47 lines
2.4 KiB
Markdown
47 lines
2.4 KiB
Markdown
## 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 |