ui-conventions

What problem does it solve?

Inconsistent UI decisions across Ensemble apps can lead to a fragmented user experience. This skill defines a centralized set of UI/UX conventions to ensure predictable navigation, visual language, and interaction patterns across all supported platforms.

Core Features & Use Cases

• Navigation & Interaction standards: Tab navigation behavior, deep linking, haptic feedback, and fallback navigation strategies to maintain consistency as users move through the app.
• Native UI Components & Platform Adaptation: Guidelines for using native components (TabView, NavigationStack vs NavigationView) and platform-specific behavior to deliver a cohesive experience on iOS, iPadOS, macOS, and watchOS.
• Visual Language, Typography & Performance: Typography, spacing, artwork handling, loading/error states, and performance best practices to keep interfaces clean and responsive.
• Use Case: When building new screens or refactoring flows, apply these conventions to ensure all navigational and visual patterns remain consistent.

Quick Start

Apply the ui-conventions guidelines whenever you start building or modifying a SwiftUI view to ensure consistent navigation, styling, and accessibility.