.NET MAUI — UI Best Practices Skill

Purpose

Core Principles

1. Simplicity first Use minimal layout nesting, clear structure, and predictable patterns.
2. Consistency Centralize styles, colors, and fonts in

   Resources/Styles

   .
3. Responsiveness Use adaptive layouts (

   OnIdiom

   ,

   OnPlatform

   ,

   Grid

   ,

   FlexLayout

   ) to support all devices.
4. Accessibility Provide semantic properties, proper contrast, and screen reader support.
5. Performance Prefer compiled bindings, lightweight controls, and efficient layout containers.

Categories of Rules

• Layout & Structure
• Styling & Theming
• Controls & Components
• Accessibility
• Performance

rules/

Agent Usage Guidelines

• When generating XAML, follow the layout and styling rules.
• When creating new pages, apply consistent structure:
  • Root layout should be

    Grid

    or

    VerticalStackLayout

    .
  • Avoid deeply nested layouts.
  • Use styles instead of inline properties.
• When generating controls, prefer reusable components in

  /Views/Controls

  .
• When asked to “make the UI responsive,” apply idiom/platform conditions.
• When asked to “improve performance,” apply rules from the performance category.

Out of Scope

• Business logic (covered in other skills)
• Authentication UI flows (covered in

  maui-authentication

  )
• Deployment or platform packaging