ui-conventions

Standardize Ensemble SwiftUI navigation, visual design, and interaction patterns across Apple platforms.

3|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/videogorl/ensemble --skill ui-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-conventions
Source: https://github.com/videogorl/ensemble/tree/main/.claude/skills/ui-conventions
Command: npx skills add https://github.com/videogorl/ensemble --skill ui-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about ui-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce consistent UI conventions across SwiftUI screens?

Standardize SwiftUI UI conventions by applying centralized guidelines for navigation patterns, visual design, and interaction behaviors. This ensures predictable user experiences across all Ensemble interfaces and eliminates fragmented visual decisions.

What's the best way to handle deep linking and tab navigation in a multiplatform SwiftUI app?

Handle deep linking and tab navigation by defining default behaviors for tab tap interactions and fallback navigation strategies. These conventions maintain consistency as users move through iOS, iPadOS, macOS, and watchOS screens.

Should I use NavigationStack or NavigationView for iOS 15 and 16 compatibility?

iOS 15 and 16 compatibility patterns dictate choosing between NavigationStack and NavigationView based on platform targets. The conventions specify native component usage to deliver a cohesive experience across supported Apple platforms.

How do I standardize typography and loading states in SwiftUI views?

Standardize typography and loading states by following predefined visual language guidelines covering spacing, artwork handling, and error states. These standards keep interfaces clean, responsive, and accessible across all new view implementations.

When do I need to apply UI/UX conventions during SwiftUI development?

Apply UI/UX conventions whenever building new SwiftUI screens or refactoring existing navigational flows. This ensures all tab management, visual language, and interaction patterns remain consistent across iOS, iPadOS, macOS, and watchOS.