stitch-ux-design
Apply this repository's exported Google Stitch UX design system. Use when changing Angular frontend UI, navigation, layouts, screens, components, CSS, visual states, responsive behavior, or user-facin
SKILL.mddocs/agent-skills/stitch-ux-design/SKILL.md
GitHubStitch UX Design
Use this skill for UI implementation and review work in projects/frontend.
Required reading:
docs/guidelines/stitch-ux-design.mddocs/adr/20260613-1009-implement-stitch-ux-design-system.md
When implementing or reviewing a specific screen, also inspect the matching files inside docs/guidelines/stitch_color_toggle_gym_tracker.zip:
- Sign-in:
sign_in_color_toggle_app/code.htmlandscreen.png - Buttons desktop:
your_color_buttons/code.htmlandscreen.png - Buttons mobile:
buttons_mobile_view/code.htmlandscreen.png - Map desktop:
gym_map/code.htmlandscreen.png - Map mobile:
gym_map_mobile_view/code.htmlandscreen.png - Defenders desktop:
defenders_management/code.htmlandscreen.png - Defenders mobile:
defenders_mobile_view/code.htmlandscreen.png - Design tokens:
indigo_utility/DESIGN.md
Implementation approach:
- Preserve existing Angular behavior, services, routes, Signals, repositories, auth, storage, geolocation, and Leaflet map lifecycle.
- Translate the Stitch design into Angular templates, component CSS, and shared style tokens.
- Migrate incrementally by screen rather than rebuilding from static exported HTML.
- Preserve loading, saving, refreshing, empty, validation, and error states.
- Verify affected layouts on mobile and desktop.
Guardrails:
- Keep the first signed-in screen usable; do not add a marketing landing page.
- Keep the Buttons screen pessimistic: tile state changes only after persistence succeeds.
- Keep map workflows intact: crosshair, current-location control, save/edit panels, and marker click editing.
- Keep Defenders workflows intact: Defending/Nearby tabs, quick defend, inline edit, delete confirmation, refresh, and empty states.
- Use Indigo Utility styling rather than default Bootstrap visual chrome.