swiftui-ui-patterns
Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.
How to use
Określ typ interakcji, którą budujesz — lista, szczegóły, edytor, ustawienia czy interfejs z zakładkami — i znajdź zbliżony przykład w repozytorium za pomocą wyszukiwania (np. rg "TabView("). Przeczytaj kod istniejącego widoku SwiftUI, aby zrozumieć konwencje projektu.
Dla nowego projektu zacznij od pliku references/app-wiring.md, aby połączyć TabView, NavigationStack i sheets. Stwórz minimalny AppTab i RouterPath na podstawie podanych szablonów, a następnie rozszerzaj enumeracje tras w miarę dodawania nowych ekranów.
Wybierz odpowiednią referencję komponentu z references/components-index.md na podstawie interfejsu, który chcesz zbudować jako pierwszy (TabView, NavigationStack, Sheets lub inne).
Stosuj nowoczesny stan SwiftUI — @State, @Binding, @Observable, @Environment — i unikaj niepotrzebnych view modeli. Utrzymuj stan lokalnie, gdy to możliwe, i używaj dependency injection dla współdzielonych zależności.
Jeśli implementujesz ujawnianie zawartości poprzez przeciąganie lub przewijanie, przeczytaj references/scroll-reveal.md przed ręcznym kodowaniem gestów. Buduj widoki z małych, skoncentrowanych podwidoków i natywnego przepływu danych SwiftUI.
Dla starszych celów wdrożenia (iOS 16 lub wcześniej) zastosuj ObservableObject z @StateObject dla właściciela głównego i @ObservedObject dla wstrzykiwanych zależności, zamiast nowszego API Observation z iOS 17.