Communitygithub.com

ComeOnOliver/skillshub

À utiliser lors du débogage de problèmes de navigation, de popups inattendus, d'écrans incorrects pour les liens profonds, de perte d'état lors du changement d'onglet ou de mise en arrière-plan, de plantages dans navigationDestination, ou de toute défaillance de navigation SwiftUI - diagnostics systématiques avec défense contre les crises de production.

Qu'est-ce que skillshub ?

Cette compétence fournit un cadre de diagnostic systématique pour résoudre les problèmes de navigation SwiftUI. Elle repose sur le principe fondamental que 85 % des problèmes de navigation proviennent d'erreurs de gestion de l'état du chemin, de problèmes d'identité de vue ou d'erreurs de placement, et non de défauts du framework SwiftUI lui-même. La compétence guide l'utilisateur à travers une série d'étapes obligatoires, comprenant l'ajout de logs de chemin (`onChange`), la vérification de la visibilité de `navigationDestination`, et l'inspection de la hiérarchie des vues, avant de proposer un arbre de décision structuré pour identifier rapidement le modèle de diagnostic approprié en fonction du symptôme (par exemple, navigation qui ne répond pas, pop inattendu, lien profond qui échoue, perte d'état, plantage). Chaque modèle de diagnostic (Pattern 1a à 6c) comprend les symptômes, le diagnostic, les correctifs détaillés et les étapes de vérification. La compétence interdit explicitement les solutions de contournement comme l'encapsulation avec `UINavigationController`, insistant sur le fait que le comportement de `NavigationStack` est déterministe et que les problèmes proviennent presque toujours d'erreurs de code. Elle prend en charge les diagnostics pour `NavigationStack`, `NavigationSplitView` et `NavigationLink`, et est conçue pour être utilisée avec des outils de développement IA comme Claude Code, Cursor ou Codex afin de réduire les heures de débogage à quelques minutes.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Diagnostics de Navigation SwiftUI

Aperçu

Principe fondamental : 85 % des problèmes de navigation proviennent d'erreurs de gestion de l'état du chemin, de problèmes d'identité de vue ou d'erreurs de placement, et non de défauts de SwiftUI.

Le système de navigation de SwiftUI est utilisé par des millions d'applications et gère de manière fiable des schémas de navigation complexes. Si votre navigation échoue, ne répond pas ou se comporte de manière inattendue, le problème vient presque toujours de la façon dont vous gérez l'état de la navigation, et non du framework lui-même.

Cette compétence fournit des diagnostics systématiques pour identifier les causes profondes en quelques minutes, et non en plusieurs heures.

Signaux d'alarme — Suspectez un problème de navigation

Si vous voyez l'UN de ces symptômes, suspectez un problème de code, pas une rupture du framework :

  • Un appui sur la navigation ne fait rien (le lien est présent mais ne pousse pas)

  • Le bouton retour revient à un écran incorrect ou à la racine

  • Un lien profond ouvre l'application mais affiche le mauvais écran

  • L'état de navigation est perdu lors du changement d'onglet

  • L'état de navigation est perdu lorsque l'application passe en arrière-plan

  • Un même NavigationLink pousse deux fois

  • L'animation de navigation est bloquée ou saccadée

  • Plantage avec navigationDestination dans la trace de la pile

  • ❌ INTERDIT "La navigation SwiftUI est cassée, enveloppons-la avec UINavigationController"

    • NavigationStack est utilisé par les propres applications d'Apple
    • Envelopper UIKit ajoute de la complexité et perd les avantages de la gestion d'état de SwiftUI
    • L'interopérabilité avec UIKit a ses propres cas particuliers que vous passerez des semaines à découvrir
    • Votre problème est presque certainement une gestion de chemin, pas un défaut du framework

Distinction critique : Le comportement de NavigationStack est déterministe. S'il ne fonctionne pas, vous modifiez l'état de manière incorrecte, vous avez des problèmes d'identité de vue, ou navigationDestination est mal placé.

Premières étapes obligatoires

Exécutez TOUJOURS ces vérifications en premier (avant de modifier le code) :

// 1. Ajouter la journalisation de NavigationPath
NavigationStack(path: $path) {
    RootView()
        .onChange(of: path.count) { oldCount, newCount in
            print("📍 Chemin changé : \(oldCount) → \(newCount)")
            // Si cela ne se déclenche jamais, le lien ne modifie pas le chemin
            // Si cela se déclenche de manière inattendue, autre chose modifie le chemin
        }
}

// 2. Vérifier que navigationDestination est visible
// Mettre une impression temporaire dans la fermeture de destination
.navigationDestination(for: Recipe.self) { recipe in
    let _ = print("🔗 Destination pour Recipe : \(recipe.name)")
    RecipeDetail(recipe: recipe)
}
// Si cela ne s'imprime jamais, la destination n'est pas évaluée

// 3. Vérifier que NavigationLink est à l'intérieur de NavigationStack
// Inspection visuelle : Tracez depuis NavigationLink dans la hiérarchie des vues
// Doit atteindre NavigationStack, et non un autre conteneur en premier

// 4. Vérifier l'emplacement de l'état du chemin
// @State doit être dans une vue stable (pas recréée à chaque rendu)
// Doit être @State, @StateObject ou @Observable — pas une variable locale

// 5. Tester le cas de base isolément
// Créer une reproduction minimale
NavigationStack {
    NavigationLink("Test", value: "test")
        .navigationDestination(for: String.self) { str in
            Text("Poussé : \(str)")
        }
}
// Si cela fonctionne, le problème vient de votre configuration spécifique

Ce que cela vous indique

ObservationDiagnosticProchaine étape
onChange ne se déclenche jamais lors d'un appuiNavigationLink pas dans la hiérarchie NavigationStackPattern 1a
onChange se déclenche mais la vue ne pousse pasnavigationDestination introuvable/non chargéePattern 1b
onChange se déclenche, la vue pousse, puis pop immédiatementProblème d'identité de vue ou modification du cheminPattern 2a
Le chemin change de manière inattendue (pas à cause d'un appui)Code externe modifiant le cheminPattern 2b
path.append() d'un lien profond ne navigue pasProblème de synchronisation ou mauvais threadPattern 3b
État perdu lors du changement d'ongletNavigationStack partagé entre les ongletsPattern 4a
Fonctionne la première fois, échoue au retourProblème de recréation de vuePattern 5a

INTERPRÉTATION OBLIGATOIRE

Avant de modifier le MOINDRE code, identifiez l'UN de ces éléments :

  1. Si un appui sur un lien ne fait rien ET aucun onChange → Lien en dehors de NavigationStack (vérifiez la hiérarchie)
  2. Si onChange se déclenche mais rien ne pousse → navigationDestination hors de portée (vérifiez l'emplacement)
  3. Si une vue pousse puis pop immédiatement → Changement d'identité de vue ou réinitialisation du chemin (vérifiez l'emplacement de @State)
  4. Si un lien profond échoue → Problème de synchronisation ou de MainActor (vérifiez le thread)
  5. En cas de plantage → Déballage forcé sur le décodage du chemin ou enregistrement de type manquant

Si les diagnostics sont contradictoires ou peu clairs

  • ARRÊTEZ. N'appliquez pas encore les modèles
  • Ajoutez des instructions d'impression à chaque point de modification du chemin
  • Créez un cas de reproduction minimal
  • Testez d'abord avec des valeurs String (cas le plus simple)

Arbre de décision

Utilisez ceci pour atteindre le modèle de diagnostic correct en 2 minutes :

Problème de navigation ?
├─ Un appui sur la navigation ne fait rien ?
│  ├─ NavigationLink à l'intérieur de NavigationStack ?
│  │  ├─ Non → Pattern 1a (Lien en dehors de la pile)
│  │  └─ Oui → Vérifier navigationDestination
│  │
│  ├─ navigationDestination enregistré ?
│  │  ├─ Dans un conteneur paresseux ? → Pattern 1b (Chargement paresseux)
│  │  ├─ Incompatibilité de type ? → Pattern 1c (Enregistrement de type)
│  │  └─ Bloqué par sheet/popover ? → Pattern 1d (Blocage modal)
│  │
│  └─ Utilisation d'un lien basé sur une vue ?
│     └─ → Pattern 1e (API obsolète)
│
├─ Retour inattendu (pop) ?
│  ├─ Pop immédiat après poussée ?
│  │  ├─ Le corps de la vue recrée le chemin ? → Pattern 2a (Recréation du chemin)
│  │  ├─ @State dans la mauvaise vue ? → Pattern 2a (Emplacement de l'état)
│  │  └─ L'identifiant ForEach change ? → Pattern 2c (Changement d'identité)
│  │
│  ├─ Pop alors que cela ne devrait pas ?
│  │  ├─ Code externe appelant removeLast ? → Pattern 2b (Modification inattendue)
│  │  ├─ Tâche annulée ? → Pattern 2b (Annulation asynchrone)
│  │  └─ Problème de MainActor ? → Pattern 2d (Threading)
│  │
│  └─ Comportement du bouton retour incorrect ?
│     └─ → Pattern 2e (Corruption de pile)
│
├─ Lien profond ne fonctionne pas ?
│  ├─ URL non reçue ?
│  │  ├─ onOpenURL non appelé ? → Vérifiez le schéma d'URL dans Info.plist
│  │  └─ Problème de liens universels ? → Vérifiez apple-app-site-association
│  │
│  ├─ URL reçue, chemin non mis à jour ?
│  │  ├─ path.append pas sur MainActor ? → Pattern 3a (Threading)
│  │  ├─ Problème de synchronisation (application pas prête) ? → Pattern 3b (Initialisation)
│  │  └─ NavigationStack pas encore créé ? → Pattern 3b (Cycle de vie)
│  │
│  └─ Chemin mis à jour, mauvais écran affiché ?
│     ├─ Ordre de chemin incorrect ? → Pattern 3c (Construction du chemin)
│     ├─ Mauvais type ajouté ? → Pattern 3c (Incompatibilité de type)
│     └─ Élément introuvable ? → Pattern 3d (Résolution de données)
│
├─ État perdu ?
│  ├─ Perdu lors du changement d'onglet ?
│  │  ├─ NavigationStack partagé ? → Pattern 4a (État partagé)
│  │  └─ Recréation d'onglet ? → Pattern 4a (Identité d'onglet)
│  │
│  ├─ Perdu lors du passage en arrière-plan/premier plan ?
│  │  ├─ Pas de SceneStorage ? → Pattern 4b (Absence de persistance)
│  │  └─ Échec de décodage ? → Pattern 4c (Erreur de décodage)
│  │
│  └─ Perdu lors de la rotation/du changement de taille ?
│     └─ → Pattern 4d (Recréation de mise en page)
│
├─ Problème de NavigationSplitView ?
│  ├─ Barre latérale non visible sur iPad ?
│  │  ├─ columnVisibility non défini ? → Pattern 6a (Visibilité des colonnes)
│  │  └─ Classe de taille compacte ? → Pattern 6a (Adaptation automatique)
│  │
│  ├─ Détail affiché vide sur iPad ?
│  │  ├─ Pas de vue de détail par défaut ? → Pattern 6b (Détail manquant)
│  │  └─ Liaison de sélection nulle ? → Pattern 6b (État de sélection)
│  │
│  └─ Fonctionne sur iPhone, cassé sur iPad ?
│     └─ → Pattern 6c (Adaptation à la plateforme)
│
└─ Plantage ?
   ├─ EXC_BAD_ACCESS dans le code de navigation ?
   │  └─ → Pattern 5a (Problème de mémoire)
   │
   ├─ Erreur fatale : type non enregistré ?
   │  └─ → Pattern 5b (Destination manquante)
   │
   └─ Échec de décodage lors de la restauration ?
      └─ → Pattern 5c (Plantage de restauration)

Règles de sélection des modèles (OBLIGATOIRE)

Avant de passer à un modèle :

  1. Un appui sur la navigation ne fait rien → Ajoutez la journalisation onChange EN PREMIER, puis Pattern 1
  2. Pop inattendu → Trouvez CE qui modifie le chemin (journalisation), puis Pattern 2
  3. Lien profond échoue → Vérifiez que l'URL est reçue (print dans onOpenURL), puis Pattern 3
  4. État perdu → Identifiez QUAND il est perdu (changement d'onglet vs arrière-plan), puis Pattern 4
  5. Plantage → Obtenez la trace de pile complète, puis Pattern 5

Appliquez UN modèle à la fois

  • Implémentez le correctif d'un seul modèle
  • Testez minutieusement
  • Si le problème persiste seulement, essayez le modèle suivant
  • N'appliquez PAS plusieurs modèles simultanément (vous ne pouvez pas isoler la cause)

INTERDIT

  • Deviner des solutions sans diagnostics
  • Modifier plusieurs choses à la fois
  • Envelopper avec UINavigationController "parce que SwiftUI est cassé"
  • Ajouter des retards/DispatchQueue.main.async sans comprendre pourquoi
  • Passer à NavigationLink basé sur une vue "pour éviter les problèmes de chemin"

Modèles de diagnostic

Modèle 1a : NavigationLink en dehors de NavigationStack

Coût en temps 5 à 10 minutes

Symptôme

  • Appuyer sur NavigationLink ne fait rien
  • Aucune navigation ne se produit, aucune erreur
  • onChange(of: path) ne se déclenche jamais

Diagnostic

// Vérifier la hiérarchie des vues — NavigationLink doit être à L'INTÉRIEUR de NavigationStack

// ❌ MAUVAIS — Lien en dehors de la pile
struct ContentView: View {
    var body: some View {
        VStack {
            NavigationLink("Aller", value: "test")  // Hors de la pile !
            NavigationStack {
                Text("Racine")
            }
        }
    }
}

// Vérifier : Ajoutez une couleur d'arrière-plan à NavigationStack
NavigationStack {
    Color.red  // Si le lien est sur rouge, il est à l'intérieur
}

Correctif

// ✅ CORRECT — Lien à l'intérieur de la pile
struct ContentView: View {
    var body: some View {
        NavigationStack {
            VStack {
                NavigationLink("Aller", value: "test")  // À l'intérieur de la pile
                Text("Racine")
            }
            .navigationDestination(for: String.self) { str in
                Text("Poussé : \(str)")
            }
        }
    }
}

Vérification

  • Appuyez sur le lien, la navigation se produit
  • onChange(of: path) se déclenche lors de l'appui

Modèle 1b : navigationDestination dans un conteneur paresseux

Coût en temps 10 à 15 minutes

Symptôme

  • L'appui sur NavigationLink ne fait rien OU fonctionne par intermittence
  • onChange se déclenche (chemin mis à jour) mais la vue ne pousse pas
  • La console peut afficher : "A navigationDestination for [Type] was not found"

Diagnostic

// ❌ MAUVAIS — Destination dans un conteneur paresseux (peut ne pas être chargée)
ScrollView {
    LazyVStack {
        ForEach(items) { item in
            NavigationLink(item.name, value: item)
                .navigationDestination(for: Item.self) { item in
                    ItemDetail(item: item)  // Peut ne pas être évaluée !
                }
        }
    }
}

Correctif

// ✅ CORRECT — Destination en dehors du conteneur paresseux
ScrollView {
    LazyVStack {
        ForEach(items) { item in
            NavigationLink(item.name, value: item)
        }
    }
}
.navigationDestination(for: Item.self) { item in
    ItemDetail(item: item)  // Toujours disponible
}

Vérification

  • Ajoutez print dans la fermeture de destination — doit toujours s'imprimer lors de la navigation
  • Fonctionne quelle que soit la position de défilement

Modèle 1c : Incompatibilité d'enregistrement de type

Coût en temps 10 minutes

Symptôme

  • L'appui sur la navigation ne fait rien
  • Aucune navigationDestination correspondante pour le type de valeur
  • Peut fonctionner pour certains liens, pas pour d'autres

Diagnostic

// Vérifier : Le type de valeur doit correspondre EXACTEMENT au type de destination

// Le lien utilise Recipe
NavigationLink(recipe.name, value: recipe)  // value est Recipe

// Destination enregistrée pour... Recipe.ID ?
.navigationDestination(for: Recipe.ID.self) { id in  // ❌ Mauvais type !
    RecipeDetail(id: id)
}

Correctif

// Faire correspondre les types exactement
NavigationLink(recipe.name, value: recipe)  // Recipe

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

// OU changer le lien pour utiliser l'ID
NavigationLink(recipe.name, value: recipe.id)  // Recipe.ID

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

Vérification

  • Imprimez le type dans la destination : print(type(of: value))
  • Les types doivent correspondre exactement (pas d'héritage)

Modèle 2a : NavigationPath recréé à chaque rendu

Coût en temps 15 à 20 minutes

Symptôme

  • La navigation pousse puis revient immédiatement (pop)
  • La vue de destination semble "clignoter"
  • Fonctionne une fois, puis échoue, ou échoue immédiatement

Diagnostic

// ❌ MAUVAIS — Chemin créé dans le corps de la vue (réinitialisé à chaque rendu)
struct ContentView: View {
    var body: some View {
        let path = NavigationPath()  // Recréé à chaque fois !
        NavigationStack(path: .constant(path)) {
            // ...
        }
    }
}

// ❌ MAUVAIS — @State dans une vue enfant qui est recréée
struct ParentView: View {
    @State var showChild = true
    var body: some View {
        if showChild {
            ChildView()  // Recréé lorsque showChild est basculé
        }
    }
}

struct ChildView: View {
    @State var path = NavigationPath()  // Perdu lorsque ChildView est recréé
    // ...
}

Correctif

// ✅ CORRECT — @State à un niveau stable
struct ContentView: View {
    @State private var path = NavigationPath()  // Persiste entre les rendus

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

// ✅ CORRECT — @StateObject pour ObservableObject
struct ContentView: View {
    @StateObject private var navModel = NavigationModel()

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

Vérification

  • Ajoutez la journalisation onChange — le chemin ne doit pas se réinitialiser de manière inattendue
  • Naviguez, attendez, path.count reste stable

Modèle 2d : Chemin modifié en dehors de MainActor

Coût en temps 10 à 15 minutes

Symptôme

  • La navigation fonctionne parfois, échoue à d'autres moments
  • Avertissements Swift 6 concernant l'isolation MainActor
  • Pops inattendus ou corruption d'état

Diagnostic

// ❌ MAUVAIS — Modification du chemin depuis une tâche en arrière-plan
func loadAndNavigate() async {
    let recipe = await fetchRecipe()
    path.append(recipe)  // ⚠️ Pas sur MainActor !
}

// Vérifier : Recherchez path.append, path.removeLast en dehors du contexte @MainActor

Correctif

// ✅ CORRECT — Assurer MainActor
@MainActor
func loadAndNavigate() async {
    let recipe = await fetchRecipe()
    path.append(recipe)  // ✅ Isolé MainActor
}

// OU distribuer explicitement
func loadAndNavigate() async {
    let recipe = await fetchRecipe()
    await MainActor.run {
        path.append(recipe)
    }
}

// ✅ MEILLEUR — Utiliser @Observable avec @ObservationTracked

Vérification

  • La navigation fonctionne de manière cohérente
  • Aucun avertissement MainActor dans le code de navigation

Modèle 4c : Échec du décodage de NavigationPath

Coût en temps 15 à 20 minutes

Symptôme

  • L'état de navigation est perdu lors de la mise en arrière-plan
  • Plantage lors de la restauration de l'état
  • "Fatal error: try! encountered decoding error"

Diagnostic

// ❌ MAUVAIS — Types non encodables dans NavigationPath
// NavigationPath nécessite que tous les types soient Codable
NavigationStack(path: $path) {
    RootView()
}
// Si un type non-Codable est ajouté, le décodage échoue

// Vérifier : Imprimez les types de chemin
print("Types dans le chemin :", path.codable.map { $0 })  // Peut être nil si non Codable

Correctif

// ✅ CORRECT — Assurer que tous les types de valeurs de navigation sont Codable
struct Recipe: Hashable, Codable {
    let id: Int
    let name: String
}

// OU gérer le décodage de manière sécurisée avec SceneStorage
@SceneStorage("navigationPath") private var pathData: Data = Data()

var body: some View {
    let path = decodePath(from: pathData)
    NavigationStack(path: Binding(get: { path }, set: { pathData = encodePath($0) })) {
        // ...
    }
}

func decodePath(from data: Data) -> NavigationPath {
    guard let decoded = try? JSONDecoder().decode(NavigationPath.CodableRepresentation.self, from: data) else {
        return NavigationPath()
    }
    return NavigationPath(decoded)
}

func encodePath(_ path: NavigationPath) -> Data {
    guard let codable = path.codable else { return Data() }
    return (try? JSONEncoder().encode(codable)) ?? Data()
}

Vérification

  • Naviguez, mettez en arrière-plan, restaurez — l'état est conservé
  • Aucun plantage lors du décodage

Modèle 4d : Recréation de mise en page

Coût en temps 10 à 15 minutes

Symptôme

  • L'état de navigation est perdu lors de la rotation ou du changement de classe de taille
  • Fonctionne en portrait, échoue en paysage (ou vice versa)
  • État réinitialisé quand l'application change de fenêtre

Diagnostic

// ❌ MAUVAIS — @State dans une vue qui est recréée lors d'un changement de mise en page
struct ContentView: View {
    @State private var path = NavigationPath()  // Perdu si ContentView est recréé
    @Environment(\.horizontalSizeClass) var sizeClass

    var body: some View {
        if sizeClass == .regular {
            NavigationSplitView {
                Sidebar()
            } detail: {
                Detail()
            }
        } else {
            NavigationStack(path: $path) {
                Content()
            }
        }
    }
}

Correctif

// ✅ CORRECT — Conserver l'état en dehors de la vue avec un changement de mise en page
class NavigationStateManager: ObservableObject {
    @Published var path = NavigationPath()
}

struct ContentView: View {
    @StateObject private var navManager = NavigationStateManager()
    @Environment(\.horizontalSizeClass) var sizeClass

    var body: some View {
        if sizeClass == .regular {
            NavigationSplitView {
                Sidebar()
            } detail: {
                Detail()
            }
        } else {
            NavigationStack(path: $navManager.path) {
                Content()
            }
        }
    }
}

Vérification

  • Tournez l'appareil — l'état de navigation est conservé
  • Changez de fenêtre (iPad) — l'état reste intact

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

Skills associés