IosTabBarTopLevel [pattern] v1.0.0

Use a persistent bottom tab bar with 3–5 items (SF Symbol icon + label) for top-level section navigation on iPhone, providing direct access to each section and preserving state independently per tab.

Label

iOS Tab Bar for Top-Level Navigation

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Problem

Apps with multiple top-level sections need a persistent navigation affordance that users can recognize and reach with their thumb, without losing context in the current section.

Solution

Implement TabView in SwiftUI (or UITabBarController in UIKit) with 3–5 Tab items. Each tab has a distinct SF Symbol and a short text label. Each tab independently maintains a NavigationStack. If there are more than 5 sections, make the fifth tab 'More' presenting a list sheet for overflow sections.

IosTabBarTopLevel [pattern] v1.0.0

Use a persistent bottom tab bar with 3–5 items (SF Symbol icon + label) for top-level section navigation on iPhone, providing direct access to each section and preserving state independently per tab.

Label

iOS Tab Bar for Top-Level Navigation

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Problem

Apps with multiple top-level sections need a persistent navigation affordance that users can recognize and reach with their thumb, without losing context in the current section.

Solution

Implement TabView in SwiftUI (or UITabBarController in UIKit) with 3–5 Tab items. Each tab has a distinct SF Symbol and a short text label. Each tab independently maintains a NavigationStack. If there are more than 5 sections, make the fifth tab 'More' presenting a list sheet for overflow sections.

Relations

related: [@community/anti-pattern-ios-hamburger-menu, @community/rule-ios-tab-bar-always-visible, @community/rule-ios-sf-symbols-tab-bar, @community/constraint-mobile-touch-target-44px, @community/check-touch-target-min, @community/check-mobile-first, @community/check-focus-visible]

Label

iOS Tab Bar for Top-Level Navigation

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Problem

Apps with multiple top-level sections need a persistent navigation affordance that users can recognize and reach with their thumb, without losing context in the current section.

Solution

Implement TabView in SwiftUI (or UITabBarController in UIKit) with 3–5 Tab items. Each tab has a distinct SF Symbol and a short text label. Each tab independently maintains a NavigationStack. If there are more than 5 sections, make the fifth tab 'More' presenting a list sheet for overflow sections.