Responsive Layout Design
Trigger Boundary
- •Use when layouts break or become unusable across device sizes.
- •Do not use for visual token definition; use
design-tokens. - •Do not use for end-to-end handoff packaging; use
figma-handoff.
Goal
Ensure layouts remain usable, readable, and consistent across screen contexts.
Shared Design Contract (Canonical)
- •Use
../design-principles/references/design-governance-contract.mdas the single schema and gate source. - •Track responsive rules with
RESP-RUL-*IDs. - •Run machine validation:
python3 ../design-principles/scripts/validate_design_contract.py --manifest <path/to/manifest.json>.
Inputs
- •Breakpoint requirements and device usage data
- •Current layout failures and overflow risks
- •Content constraints and localization expansion risk
Outputs
- •Responsive rule set with
RESP-RUL-*IDs - •Breakpoint behavior and component adaptation specs
- •Risk list for overflow, truncation, and interaction issues
Workflow
- •Define breakpoint model and layout priorities.
- •Specify component adaptation per breakpoint.
- •Validate text expansion and localization stress cases.
- •Define interaction affordance changes for touch and pointer contexts.
- •Document regression checkpoints for critical screens.
Quality Gates
- •Core tasks remain usable at all supported breakpoints.
- •Overflow and truncation are controlled for long localized strings.
- •Interaction targets remain accessible on touch devices.
- •Responsive rules are traceable and non-conflicting.
Failure Handling
- •Stop when breakpoints are chosen without user/device evidence.
- •Escalate when critical flows fail on supported viewport ranges.