Files
kandev/docs/specs/ui/requirements/executor-settings-card-spacing.md
T
2026-08-24 11:09:03 +00:00

57 lines
5.0 KiB
Markdown

---
status: active
system: ui
created: 2026-08-03
owners:
- kandev
---
# Executor settings card spacing Requirements
## Overview
Executor profile pages show several independently editable settings cards in one long form. On the modern profile edit and create routes, those cards touch edge-to-edge, which makes the form read as one dense surface and makes section boundaries harder to scan on desktop and phone screens.
## Requirements
### REQ-UI-EXECUTOR-SETTINGS-CARD-SPACING-001: Executor settings card spacing
**Intent:** Executor profile pages show several independently editable settings cards in one long form. On the modern profile edit and create routes, those cards touch edge-to-edge, which makes the form read as one dense surface and makes section boundaries harder to scan on desktop and phone screens.
#### Acceptance criteria
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.1:** Modern executor profile edit pages at `/settings/executors/:profileId` keep a consistent vertical gap between every visible settings card, including cards that appear only for a particular executor type.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.2:** Modern executor profile create pages at `/settings/executors/new/:type` use the same vertical card spacing for every supported executor type.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.3:** The spacing is the existing settings rhythm of `2rem` between adjacent cards and remains present at the configured phone viewport as well as desktop widths.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.4:** Card-internal padding, form fields, manual-save behavior, disabled-fieldset behavior, routing, and executor-specific content remain unchanged.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.5:** The profile form remains a single vertically scrolling surface and does not introduce document-level horizontal overflow on a phone viewport.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.6:** **GIVEN** a saved worktree executor profile, **WHEN** the user opens its modern profile editor, **THEN** the Profile Details, Environment Variables, Prepare Script, and any subsequent cards have a visible `2rem` vertical separation from the preceding card.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.7:** **GIVEN** a new profile form for a supported executor type, **WHEN** the user opens the form, **THEN** every visible settings card is separated by the same vertical rhythm.
- **AC-UI-EXECUTOR-SETTINGS-CARD-SPACING-001.8:** **GIVEN** a modern executor profile editor or create form on a phone-sized viewport, **WHEN** the user scrolls through the form, **THEN** adjacent cards retain the separation, remain within the viewport, and the document has no horizontal overflow.
## Migrated source detail
## Why
Executor profile pages show several independently editable settings cards in one long form. On the modern profile edit and create routes, those cards touch edge-to-edge, which makes the form read as one dense surface and makes section boundaries harder to scan on desktop and phone screens.
## What
- Modern executor profile edit pages at `/settings/executors/:profileId` keep a consistent vertical gap between every visible settings card, including cards that appear only for a particular executor type.
- Modern executor profile create pages at `/settings/executors/new/:type` use the same vertical card spacing for every supported executor type.
- The spacing is the existing settings rhythm of `2rem` between adjacent cards and remains present at the configured phone viewport as well as desktop widths.
- Card-internal padding, form fields, manual-save behavior, disabled-fieldset behavior, routing, and executor-specific content remain unchanged.
- The profile form remains a single vertically scrolling surface and does not introduce document-level horizontal overflow on a phone viewport.
## Scenarios
- **GIVEN** a saved worktree executor profile, **WHEN** the user opens its modern profile editor, **THEN** the Profile Details, Environment Variables, Prepare Script, and any subsequent cards have a visible `2rem` vertical separation from the preceding card.
- **GIVEN** a new profile form for a supported executor type, **WHEN** the user opens the form, **THEN** every visible settings card is separated by the same vertical rhythm.
- **GIVEN** a modern executor profile editor or create form on a phone-sized viewport, **WHEN** the user scrolls through the form, **THEN** adjacent cards retain the separation, remain within the viewport, and the document has no horizontal overflow.
- **GIVEN** an executor profile form is disabled while it is loading or saving, **WHEN** the spacing layout is rendered, **THEN** the fieldset remains disabled without changing the card spacing or form state.
## Out of scope
- Changing the shared card primitive's internal padding or spacing for unrelated settings pages.
- Redesigning executor settings navigation, card content, form controls, save coordination, or executor-specific behavior.
- Adding a new mobile navigation surface or changing desktop preferences on phone viewports.