gh-Dimillian-Skills/swiftui-ui-patterns/references/components-index.md

Components Index

Use this file to find component-specific guidance. Each entry lists when to use it.

Available components

• TabView: references/tabview.md — Use when building a tab-based app or any tabbed feature set.
• NavigationStack: references/navigationstack.md — Use when you need push navigation and programmatic routing, especially per-tab history.
• Sheets and modal routing: references/sheets.md — Use when you want centralized, enum-driven sheet presentation.
• App scaffolding wiring: references/app-scaffolding-wiring.md — Use to wire TabView + NavigationStack + sheets at the root.
• Form and Settings: references/form.md — Use for settings, grouped inputs, and structured data entry.
• Split views and columns: references/split-views.md — Use for iPad/macOS multi-column layouts or custom secondary columns.
• List and Section: references/list.md — Use for feed-style content and settings rows.
• ScrollView and Lazy stacks: references/scrollview.md — Use for custom layouts, horizontal scrollers, or grids.
• Grids: references/grids.md — Use for icon pickers, media galleries, and tiled layouts.
• Theming and dynamic type: references/theming.md — Use for app-wide theme tokens, colors, and type scaling.
• Controls (toggles, pickers, sliders): references/controls.md — Use for settings controls and input selection.
• Input toolbar (bottom anchored): references/input-toolbar.md — Use for chat/composer screens with a sticky input bar.
• Top bar overlays (iOS 26+ and fallback): references/top-bar.md — Use for pinned selectors or pills above scroll content.
• Overlay and toasts: references/overlay.md — Use for transient UI like banners or toasts.
• Focus handling: references/focus.md — Use for chaining fields and keyboard focus management.
• Searchable: references/searchable.md — Use for native search UI with scopes and async results.
• Async images and media: references/media.md — Use for remote media, previews, and media viewers.
• Haptics: references/haptics.md — Use for tactile feedback tied to key actions.
• Matched transitions: references/matched-transitions.md — Use for smooth source-to-destination animations.
• Deep links and URL routing: references/deeplinks.md — Use for in-app navigation from URLs.

Planned components (create files as needed)

• Web content: create references/webview.md — Use for embedded web content or in-app browsing.
• Status composer patterns: create references/composer.md — Use for composition or editor workflows.
• Text input and validation: create references/text-input.md — Use for forms, validation, and text-heavy input.
• Design system usage: create references/design-system.md — Use when applying shared styling rules.

Adding entries

• Add the component file and link it here with a short “when to use” description.
• Keep each component reference short and actionable.