skills/mavixx-design-system/assets/DESIGN.template.md

# Design system

## Brand direction

- Product personality:
- Audience:
- Visual principles:
- Avoid:

## Foundations

- Semantic colors:
- Typography and type scale:
- Spacing and sizing:
- Grid, containers, and breakpoints:
- Borders, radii, and elevation:

## Components and states

- Navigation:
- Buttons and links:
- Forms:
- Cards/data surfaces:
- Feedback and overlays:
- Loading, empty, error, success, disabled, and focus states:

## Imagery and icons

- Art direction:
- Asset location and naming:
- Licensing/attribution constraints:

## Motion

- Purpose:
- Duration/easing:
- Scroll behavior:
- Reduced-motion behavior:

## Responsive and accessibility rules

- Mobile priorities:
- Content reflow:
- Keyboard/focus:
- Contrast and semantics:

## Approved references

- Reference:
- Adopted principles:
- Excluded elements:

## Implementation mapping

- Token/theme files:
- Shared component files:
- Application shell/navigation files:
- Representative routes to upgrade first:
- Legacy styles to retain until verified:

## Rendered validation

- Desktop routes and states:
- Mobile routes and states:
- Primary interactions:
- Known constraints or remaining risks: