Communitygithub.com

SwiftUI Navigation Diagnostics

Systematische Fehlerdiagnose und Behebung von SwiftUI-Navigationsproblemen, einschließlich nicht reagierender Navigation, unerwarteten Pops, Deep-Link-Fehlern und Zustandsverlust.

Was ist SwiftUI Navigation Diagnostics?

Diese Fähigkeit bietet eine strukturierte, methodische Anleitung zur Diagnose und Behebung von Navigationsproblemen in SwiftUI, wie sie in Agenten wie Claude Code, Cursor oder Codex eingesetzt werden kann. Sie basiert auf dem Prinzip, dass 85 % aller Navigationsfehler auf Fehler im Pfadzustandsmanagement, Ansichtsidentität oder falsche Platzierung zurückzuführen sind – nicht auf Framework-Fehler. Das Skill enthält ein Entscheidungsbaum-Diagramm, das den Entwickler in wenigen Minuten zum richtigen Diagnosemuster führt, sowie obligatorische erste Schritte mit Protokollierung und Isolationstests. Es behandelt elf detaillierte Diagnosemuster – von NavigationLink außerhalb des NavigationStack über Typkonflikte bis hin zu MainActor-Problemen und Abstürzen. Die Anleitung ist plattformunabhängig und hilft, typische Fehler wie falsche @State-Platzierung, lazy geladene navigationDestination oder nicht beachtete Threading-Anforderungen zu vermeiden. Sie verbietet ausdrücklich das Umwickeln mit UINavigationController oder das Raten ohne systematische Diagnose.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-nav-diag

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SwiftUI Navigationsdiagnose

Überblick

Kernprinzip 85 % der Navigationsprobleme stammen von Pfadzustandsverwaltungsfehlern, Ansichtsidentitätsproblemen oder Platzierungsfehlern – nicht von SwiftUI-Fehlern.

SwifUIs Navigationssystem wird von Millionen von Apps genutzt und bewältigt komplexe Navigationsmuster zuverlässig. Wenn Ihre Navigation fehlschlägt, nicht reagiert oder sich unerwartet verhält, liegt das Problem fast immer in der Art und Weise, wie Sie den Navigationszustand verwalten, nicht im Framework selbst.

Diese Fähigkeit bietet eine systematische Diagnose, um die Ursachen in Minuten statt Stunden zu identifizieren.

Alarmzeichen – Navigationsproblem vermuten

Wenn Sie EINES dieser Symptome sehen, vermuten Sie einen Code-Fehler, keinen Framework-Fehler:

  • Navigationstaste tut nichts (Link vorhanden, aber es wird nicht weitergeleitet)

  • Zurück-Button navigiert zum falschen Bildschirm oder zur Startseite zurück

  • Deep Link öffnet App, aber zeigt falschen Bildschirm

  • Navigationszustand beim Wechseln von Tabs verloren

  • Navigationszustand beim Hintergrundlegen der App verloren

  • Gleicher NavigationLink wird zweimal gedrückt

  • Navigationsanimation hängt oder ruckelt

  • Absturz mit navigationDestination im Stack-Trace

  • ❌ VERBOTEN „SwiftUI-Navigation ist kaputt, lass uns UINavigationController einwickeln“

    • NavigationStack wird von Apples eigenen Apps verwendet
    • UIKit-Einwicklung fügt Komplexität hinzu und verliert die Vorteile der SwiftUI-Zustandsverwaltung
    • UIKit-Interop hat eigene Randfälle, die Sie Wochen entdecken lassen
    • Ihr Problem ist mit ziemlicher Sicherheit Pfadverwaltung, kein Framework-Fehler

Wichtige Unterscheidung Das Verhalten von NavigationStack ist deterministisch. Wenn es nicht funktioniert, ändern Sie den Zustand falsch, haben Ansichtsidentitätsprobleme oder navigationDestination ist falsch platziert.

Obligatorische erste Schritte

Führen Sie IMMER diese Prüfungen ZUERST durch (bevor Sie Code ändern):

// 1. NavigationPath-Protokollierung hinzufügen
NavigationStack(path: $path) {
    RootView()
        .onChange(of: path.count) { oldCount, newCount in
            print("📍 Pfad geändert: \(oldCount) → \(newCount)")
            // Wenn dies nie feuert, ändert der Link den Pfad nicht
            // Wenn es unerwartet feuert, ändert etwas anderes den Pfad
        }
}

// 2. Prüfen, ob navigationDestination sichtbar ist
// Temporäres print in die Ziel-Closure setzen
.navigationDestination(for: Recipe.self) { recipe in
    let _ = print("🔗 Ziel für Recipe: \(recipe.name)")
    RecipeDetail(recipe: recipe)
}
// Wenn dies nie gedruckt wird, wird das Ziel nicht ausgewertet

// 3. Prüfen, ob NavigationLink innerhalb von NavigationStack ist
// Sichtprüfung: Vom NavigationLink die Ansichtshierarchie hochgehen
// Muss NavigationStack treffen, nicht zuerst einen anderen Container

// 4. Pfadzustandsposition prüfen
// @State muss in stabiler Ansicht sein (nicht bei jedem Rendern neu erstellt)
// Muss @State, @StateObject oder @Observable sein – keine lokale Variable

// 5. Basisfall isoliert testen
// Minimale Reproduktion erstellen
NavigationStack {
    NavigationLink("Test", value: "test")
        .navigationDestination(for: String.self) { str in
            Text("Gepusht: \(str)")
        }
}
// Wenn dies funktioniert, liegt das Problem in Ihrem spezifischen Setup

Was Ihnen das sagt

BeobachtungDiagnoseNächster Schritt
onChange feuert nie bei TippenNavigationLink nicht in NavigationStack-HierarchieMuster 1a
onChange feuert, aber Ansicht schiebt nichtnavigationDestination nicht gefunden/geladenMuster 1b
onChange feuert, Ansicht schiebt, dann sofort zurückAnsichtsidentitätsproblem oder PfadänderungMuster 2a
Pfad ändert sich unerwartet (nicht durch Tippen)Externer Code ändert PfadMuster 2b
Deep-Link path.append() navigiert nichtTiming-Problem oder falscher ThreadMuster 3b
Zustand beim Tab-Wechsel verlorenNavigationStack wird über Tabs geteiltMuster 4a
Funktioniert beim ersten Mal, schlägt bei Rückkehr fehlAnsichts-NeuerstellungsproblemMuster 5a

VERPFLICHTENDE INTERPRETATION

Bevor Sie IRGENDEINEN Code ändern, identifizieren Sie EINES dieser:

  1. Wenn Link-Tippen nichts tut UND kein onChange → Link außerhalb von NavigationStack (Hierarchie prüfen)
  2. Wenn onChange feuert, aber nichts schiebt → navigationDestination nicht im Gültigkeitsbereich (Platzierung prüfen)
  3. Wenn schiebt und dann sofort zurückgeht → Ansichtsidentitätsänderung oder Pfadzurücksetzung (@State-Position prüfen)
  4. Wenn Deep Link fehlschlägt → Timing- oder MainActor-Problem (Thread prüfen)
  5. Wenn Absturz → Force-Unwrap bei Pfaddecodierung oder fehlende Typregistrierung

Wenn die Diagnosen widersprüchlich oder unklar sind

  • STOPPEN Sie. Gehen Sie NOCH NICHT zu Mustern über
  • Fügen Sie Print-Anweisungen an jedem Pfadänderungspunkt hinzu
  • Erstellen Sie einen minimalen Reproduktionsfall
  • Testen Sie zuerst mit String-Werten (einfachster Fall)

Entscheidungsbaum

Verwenden Sie dies, um in 2 Minuten zum richtigen Diagnosemuster zu gelangen:

Navigationsproblem?
├─ Navigationstipp tut nichts?
│  ├─ NavigationLink innerhalb von NavigationStack?
│  │  ├─ Nein → Muster 1a (Link außerhalb des Stacks)
│  │  └─ Ja → navigationDestination prüfen
│  │
│  ├─ navigationDestination registriert?
│  │  ├─ In lazy container? → Muster 1b (Lazy Loading)
│  │  ├─ Typkonflikt? → Muster 1c (Typregistrierung)
│  │  └─ Durch sheet/popover blockiert? → Muster 1d (Modale Blockierung)
│  │
│  └─ Ansichtsbasierter Link verwendet?
│     └─ → Muster 1e (Veraltete API)
│
├─ Unerwarteter Pop zurück?
│  ├─ Sofortiger Pop nach Push?
│  │  ├─ Ansichts-body erstellt Pfad neu? → Muster 2a (Pfadneuerstellung)
│  │  ├─ @State in falscher Ansicht? → Muster 2a (Zustandsposition)
│  │  └─ ForEach id geändert? → Muster 2c (Identitätsänderung)
│  │
│  ├─ Pop, wenn nicht sollte?
│  │  ├─ Externer Code ruft removeLast auf? → Muster 2b (Unerwartete Änderung)
│  │  ├─ Task abgebrochen? → Muster 2b (Async-Abbruch)
│  │  └─ MainActor-Problem? → Muster 2d (Threading)
│  │
│  └─ Zurück-Button-Verhalten falsch?
│     └─ → Muster 2e (Stack-Beschädigung)
│
├─ Deep Link funktioniert nicht?
│  ├─ URL nicht empfangen?
│  │  ├─ onOpenURL nicht aufgerufen? → URL-Schema in Info.plist prüfen
│  │  └─ Universal Links Problem? → apple-app-site-association prüfen
│  │
│  ├─ URL empfangen, Pfad nicht aktualisiert?
│  │  ├─ path.append nicht auf MainActor? → Muster 3a (Threading)
│  │  ├─ Timing-Problem (App nicht bereit)? → Muster 3b (Initialisierung)
│  │  └─ NavigationStack noch nicht erstellt? → Muster 3b (Lebenszyklus)
│  │
│  └─ Pfad aktualisiert, falscher Bildschirm gezeigt?
│     ├─ Falsche Pfadreihenfolge? → Muster 3c (Pfadkonstruktion)
│     ├─ Falscher Typ angehängt? → Muster 3c (Typkonflikt)
│     └─ Element nicht gefunden? → Muster 3d (Datenauflösung)
│
├─ Zustand verloren?
│  ├─ Beim Tab-Wechsel verloren?
│  │  ├─ Gemeinsamer NavigationStack? → Muster 4a (Geteilter Zustand)
│  │  └─ Tab-Neuerstellung? → Muster 4a (Tab-Identität)
│  │
│  ├─ Im Hintergrund/Vordergrund verloren?
│  │  ├─ Kein SceneStorage? → Muster 4b (Keine Persistenz)
│  │  └─ Decodierungsfehler? → Muster 4c (Decode-Fehler)
│  │
│  └─ Bei Drehung/Größenänderung verloren?
│     └─ → Muster 4d (Layout-Neuerstellung)
│
├─ NavigationSplitView-Problem?
│  ├─ Sidebar auf iPad nicht sichtbar?
│  │  ├─ columnVisibility nicht gesetzt? → Muster 6a (Spaltensichtbarkeit)
│  │  └─ Kompakte Größenklasse? → Muster 6a (Automatische Anpassung)
│  │
│  ├─ Detail auf iPad leer?
│  │  ├─ Keine Standarddetailansicht? → Muster 6b (Fehlendes Detail)
│  │  └─ Auswahlbinding nil? → Muster 6b (Auswahlzustand)
│  │
│  └─ Funktioniert auf iPhone, kaputt auf iPad?
│     └─ → Muster 6c (Plattformanpassung)
│
└─ Absturz?
   ├─ EXC_BAD_ACCESS im Navigationscode?
   │  └─ → Muster 5a (Speicherproblem)
   │
   ├─ Fatal error: type not registered?
   │  └─ → Muster 5b (Fehlendes Ziel)
   │
   └─ Decodierungsfehler bei Wiederherstellung?
      └─ → Muster 5c (Wiederherstellungsabsturz)

Musterauswahlregeln (VERPFLICHTEND)

Bevor Sie zu einem Muster übergehen:

  1. Navigationstipp tut nichts → Fügen Sie ZUERST onChange-Protokollierung hinzu, dann Muster 1
  2. Unerwarteter Pop → Finden Sie HERAUS, was den Pfad ändert (Protokollierung), dann Muster 2
  3. Deep Link schlägt fehl → Überprüfen Sie, ob URL empfangen wurde (Print in onOpenURL), dann Muster 3
  4. Zustand verloren → Identifizieren Sie, WANN verloren (Tab-Wechsel vs. Hintergrund), dann Muster 4
  5. Absturz → Holen Sie den vollständigen Stack-Trace, dann Muster 5

Wenden Sie EIN Muster nach dem anderen an

  • Implementieren Sie die Korrektur aus einem Muster
  • Testen Sie gründlich
  • Nur wenn das Problem weiterhin besteht, versuchen Sie das nächste Muster
  • Wenden Sie NICHT mehrere Muster gleichzeitig an (Ursache kann nicht isoliert werden)

VERBOTEN

  • Raten von Lösungen ohne Diagnose
  • Mehrere Dinge gleichzeitig ändern
  • Mit UINavigationController umwickeln „weil SwiftUI kaputt ist“
  • Verzögerungen/DispatchQueue.main.async hinzufügen, ohne zu verstehen, warum
  • Zu ansichtsbasiertem NavigationLink wechseln „um Pfadprobleme zu vermeiden"

Diagnosemuster

Muster 1a: NavigationLink außerhalb von NavigationStack

Zeitaufwand 5–10 Minuten

Symptom

  • Tippen auf NavigationLink tut nichts
  • Keine Navigation, keine Fehler
  • onChange(of: path) feuert nie

Diagnose

// Ansichtshierarchie prüfen – NavigationLink muss INNERHALB von NavigationStack sein

// ❌ FALSCH – Link außerhalb des Stacks
struct ContentView: View {
    var body: some View {
        VStack {
            NavigationLink("Go", value: "test")  // Außerhalb des Stacks!
            NavigationStack {
                Text("Root")
            }
        }
    }
}

// Prüfen: Hintergrundfarbe zu NavigationStack hinzufügen
NavigationStack {
    Color.red  // Wenn Link auf rot, ist es innerhalb
}

Lösung

// ✅ RICHTIG – Link innerhalb des Stacks
struct ContentView: View {
    var body: some View {
        NavigationStack {
            VStack {
                NavigationLink("Go", value: "test")  // Innerhalb des Stacks
                Text("Root")
            }
            .navigationDestination(for: String.self) { str in
                Text("Gepusht: \(str)")
            }
        }
    }
}

Überprüfung

  • Link antippen, Navigation erfolgt
  • onChange(of: path) feuert bei Tippen

Muster 1b: navigationDestination in lazy container

Zeitaufwand 10–15 Minuten

Symptom

  • NavigationLink-Tippen tut nichts ODER funktioniert zeitweise
  • onChange feuert (Pfad aktualisiert), aber Ansicht schiebt nicht
  • Konsole zeigt möglicherweise: „A navigationDestination for [Type] was not found“

Diagnose

// ❌ FALSCH – Ziel innerhalb lazy container (wird möglicherweise nicht geladen)
ScrollView {
    LazyVStack {
        ForEach(items) { item in
            NavigationLink(item.name, value: item)
                .navigationDestination(for: Item.self) { item in
                    ItemDetail(item: item)  // Wird möglicherweise nicht ausgewertet!
                }
        }
    }
}

Lösung

// ✅ RICHTIG – Ziel außerhalb lazy container
ScrollView {
    LazyVStack {
        ForEach(items) { item in
            NavigationLink(item.name, value: item)
        }
    }
}
.navigationDestination(for: Item.self) { item in
    ItemDetail(item: item)  // Immer verfügbar
}

Überprüfung

  • Print in der Ziel-Closure hinzufügen – sollte bei Navigation immer drucken
  • Funktioniert unabhängig von der Scrollposition

Muster 1c: Typregistrierungskonflikt

Zeitaufwand 10 Minuten

Symptom

  • Navigationstippen tut nichts
  • Kein passendes navigationDestination für den Werttyp
  • Funktioniert möglicherweise für einige Links, für andere nicht

Diagnose

// Prüfen: Werttyp muss EXAKT mit dem Zieltyp übereinstimmen

// Link verwendet Recipe
NavigationLink(recipe.name, value: recipe)  // value ist Recipe

// Ziel registriert für... Recipe.ID?
.navigationDestination(for: Recipe.ID.self) { id in  // ❌ Falscher Typ!
    RecipeDetail(id: id)
}

Lösung

// Typen exakt übereinstimmen lassen
NavigationLink(recipe.name, value: recipe)  // Recipe

.navigationDestination(for: Recipe.self) { recipe in  // ✅ Recipe
    RecipeDetail(recipe: recipe)
}

// ODER Link ändern, um ID zu verwenden
NavigationLink(recipe.name, value: recipe.id)  // Recipe.ID

.navigationDestination(for: Recipe.ID.self) { id in  // ✅ Recipe.ID
    RecipeDetail(id: id)
}

Überprüfung

  • Typ im Ziel drucken: print(type(of: value))
  • Typen müssen exakt übereinstimmen (keine Vererbung)

Muster 2a: NavigationPath wird bei jedem Rendern neu erstellt

Zeitaufwand 15–20 Minuten

Symptom

  • Navigation schiebt und geht dann sofort zurück
  • Die Zielansicht scheint zu „blitzen“
  • Funktioniert einmal, schlägt dann fehl, oder schlägt sofort fehl

Diagnose

// ❌ FALSCH – Pfad im Ansichtsbody erstellt (bei jedem Rendern zurückgesetzt)
struct ContentView: View {
    var body: some View {
        let path = NavigationPath()  // Wird jedes Mal neu erstellt!
        NavigationStack(path: .constant(path)) {
            // ...
        }
    }
}

// ❌ FALSCH – @State in untergeordneter Ansicht, die neu erstellt wird
struct ParentView: View {
    @State var showChild = true
    var body: some View {
        if showChild {
            ChildView()  // Wird neu erstellt, wenn showChild umschaltet
        }
    }
}

struct ChildView: View {
    @State var path = NavigationPath()  // Geht verloren, wenn ChildView neu erstellt wird
    // ...
}

Lösung

// ✅ RICHTIG – @State auf stabiler Ebene
struct ContentView: View {
    @State private var path = NavigationPath()  // Besteht über Render hinweg

    var body: some View {
        NavigationStack(path: $path) {
            RootView()
        }
    }
}

// ✅ RICHTIG – @StateObject für ObservableObject
struct ContentView: View {
    @StateObject private var navModel = NavigationModel()

    var body: some View {
        NavigationStack(path: $navModel.path) {
            RootView()
        }
    }
}

Überprüfung

  • onChange-Protokollierung hinzufügen – Pfad sollte sich nicht unerwartet zurücksetzen
  • Navigieren, warten, path.count bleibt stabil

Muster 2d: Pfad außerhalb von MainActor geändert

Zeitaufwand 10–15 Minuten

Symptom

  • Navigation funktioniert manchmal, manchmal nicht
  • Swift 6-Warnungen zur MainActor-Isolation
  • Unerwartete Pops oder Zustandsbeschädigung

Diagnose

// ❌ FALSCH – Pfad aus Hintergrundtask ändern
func loadAndNavigate() async {
    let recipe = await fetchRecipe()
    path.append(recipe)  // ⚠️ Nicht auf MainActor!
}

// Prüfen: Suche nach path.append, path.removeLast außerhalb von @MainActor-Kontext

Lösung

// ✅ RICHTIG – MainActor sicherstellen
@MainActor
func loadAndNavigate() async {
    let recipe = await fetchRecipe()
    path.append(recipe)  // ✅ MainActor isoliert
}

// ODER explizit dispatchen
func loadAndNavigate() async {
    let recipe = await fetchRecipe()
    await MainActor.run {
        path.append(recipe)
    }
}

// ✅ AM BESTEN – @Observable mit @MainActor-Klasse verwenden
@MainActor
@Observable
class NavigationModel {
    var path = NavigationPath()
    
    func navigateTo(_ recipe: Recipe) {
        path.append(recipe)
    }
}

Überprüfung

  • Fügen Sie MainActor.assertIsolated() vor path.append hinzu
  • Debug-Konsole sollte keine Actor-Isolationswarnungen zeigen

Muster 4a: NavigationStack-Zustand zwischen Tabs geteilt

Zeitaufwand 15–20 Minuten

Symptom

  • Beim Tab-Wechsel geht der Navigationszustand verloren
  • Ein Tab beeinflusst die Navigation eines anderen Tabs
  • Unerwartete Zurücksetzungen beim Wechseln

Diagnose

// ❌ FALSCH – Gemeinsame path-Variable für mehrere Tabs
struct TabViewExample: View {
    @State private var path = NavigationPath()  // Wird von allen Tabs geteilt!

    var body: some View {
        TabView {
            NavigationStack(path: $path) {
                TabARoot()
            }
            .tabItem { Label("Tab A", systemImage: "a.circle") }

            NavigationStack(path: $path) {  // Gleiche path-Referenz!
                TabBRoot()
            }
            .tabItem { Label("Tab B", systemImage: "b.circle") }
        }
    }
}

Lösung

// ✅ RICHTIG – Jeder Tab bekommt seinen eigenen Pfad
struct TabViewExample: View {
    @State private var tabAPath = NavigationPath()
    @State private var tabBPath = NavigationPath()

    var body: some View {
        TabView {
            NavigationStack(path: $tabAPath) {
                TabARoot()
            }
            .tabItem { Label("Tab A", systemImage: "a.circle") }

            NavigationStack(path: $tabBPath) {
                TabBRoot()
            }
            .tabItem { Label("Tab B", systemImage: "b.circle") }
        }
    }
}

Überprüfung

  • In Tab A navigieren, zu Tab B wechseln, zurück zu Tab A → Navigation sollte erhalten bleiben
  • Änderungen in Tab B sollten Tab A nicht beeinflussen

Muster 5b: Fehlende navigationDestination-Registrierung

Zeitaufwand 10 Minuten

Symptom

  • Fataler Fehler: „No navigationDestination registered for type ...“
  • Absturz bei Navigationsversuch
  • Oft erst nach einem Restore oder Deep Link sichtbar

Diagnose

// Prüfen: Jeder verwendete Typ muss einen navigationDestination haben

// In NavigationLink verwendeter Typ
NavigationLink(value: recipeItem)  // RecipeItem

// Fehlt: .navigationDestination(for: RecipeItem.self) { ... }

Lösung

// Typen vollständig registrieren
NavigationStack(path: $path) {
    ContentView()
        .navigationDestination(for: RecipeItem.self) { item in
            RecipeDetailView(item: item)
        }
        .navigationDestination(for: CategoryItem.self) { item in
            CategoryDetailView(item: item)
        }
        // Weitere Typen nach Bedarf
}

Überprüfung

  • Liste aller Typen, die über NavigationLink oder path.append verwendet werden
  • Stellen Sie sicher, dass für jeden Typ ein navigationDestination auf einem Vorfahren im Stack registriert ist

Muster 6a: NavigationSplitView Spaltensichtbarkeit auf iPad

Zeitaufwand 10–15 Minuten

Symptom

  • Sidebar auf iPad nicht sichtbar
  • Detailansicht zeigt Standardinhalt anstelle der ausgewählten Ansicht
  • Unterschiedliches Verhalten zwischen iPhone und iPad

Diagnose

// Prüfen: columnVisibility nicht verwaltet

// ❌ FALSCH – columnVisibility nicht gesetzt
NavigationSplitView {
    SidebarView()
} detail: {
    DetailView()
}

Lösung

// ✅ RICHTIG – columnVisibility mit @State verwalten
struct SplitViewExample: View {
    @State private var columnVisibility = NavigationSplitViewVisibility.all

    var body: some View {
        NavigationSplitView(columnVisibility: $columnVisibility) {
            SidebarView()
        } detail: {
            DetailView()
        }
    }
}

Überprüfung

  • Sidebar auf iPad standardmäßig sichtbar
  • columnVisibility kann je nach Anwendungsfall auf .all, .doubleColumn oder .detailOnly gesetzt werden

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Verwandte Skills