Routeur de Skills Clerk

Détection de version

Vérifiez package.json pour déterminer la version du SDK Clerk. Cela détermine quels patterns utiliser :

Privilégiez current si la version n'est pas claire ou si le projet est nouveau. Les packages Core 2 utilisent @clerk/clerk-react et @clerk/clerk-expo (avec le préfixe clerk-) ; les packages current utilisent @clerk/react et @clerk/expo.

Tous les skills sont écrits pour le SDK current. Quand quelque chose diffère dans Core 2, c'est noté en ligne avec des callouts > **Core 2 ONLY (skip if current SDK):**. L'exception est clerk-custom-ui, qui possède des répertoires séparés core-2/ et core-3/ pour les hooks de flux personnalisés, car ces APIs sont entièrement différentes entre les versions.

Par tâche

Ajouter Clerk à votre projet → Utilisez clerk-setup

• Détection du framework et quickstart
• Configuration de l'environnement, clés API, clés dev temporaires via clerk init
• Migration depuis d'autres fournisseurs d'authentification

Opérer Clerk depuis la CLI → Utilisez clerk-cli

• Auth, linking, doctor et pulls d'environnement
• Gestion des utilisateurs, organisations, sessions, applications et instances
• Usurpation d'identité d'un utilisateur (clerk impersonate) et test local de webhooks (clerk webhooks listen)
• Feature toggles (clerk enable orgs, clerk enable billing)
• Appels des APIs Backend, Platform et Frontend via clerk api
• Handoff de déploiement et vérification du statut de déploiement

Custom sign-in/sign-up UI → Utilisez clerk-custom-ui

• Flux d'authentification personnalisés avec hooks useSignIn / useSignUp
• Apparence et style (thèmes, couleurs, mise en page)
• Composant <Show> pour le rendu conditionnel

Patterns Next.js avancés → Utilisez clerk-nextjs-patterns

• Auth APIs serveur vs client
• Stratégies middleware
• Server Actions, caching
• Protection des routes API

Patterns React → Utilisez clerk-react-patterns

• Hooks (useAuth, useUser, useClerk)
• Routes protégées, guards d'authentification
• Intégration router

Patterns React Router → Utilisez clerk-react-router-patterns

• Loaders & actions avec auth
• Protection des routes
• Auth SSR

Patterns Vue → Utilisez clerk-vue-patterns

• Composables (useAuth, useUser, useClerk)
• Vue Router guards
• Intégration Pinia auth store

Patterns Nuxt → Utilisez clerk-nuxt-patterns

• Auth middleware serveur
• Auth SSR avec composables
• Routes API serveur

Patterns Astro → Utilisez clerk-astro-patterns

• Pages SSR auth
• Island components avec React
• Middleware & routes API

Patterns TanStack Start → Utilisez clerk-tanstack-patterns

• Server functions avec auth
• Protection des routes via loaders
• Intégration serveur Vinxi

Expo / React Native auth → Utilisez clerk-expo

• Composants natifs prebuilt (AuthView, UserButton)
• Flux personnalisés : email, password, SMS/phone OTP, MFA
• OAuth/SSO et sign-in natif Google/Apple
• Routes Expo protégées, stockage de tokens, notifications push

Patterns Chrome Extension → Utilisez clerk-chrome-extension-patterns

• Auth scripts de fond
• Flux auth popup
• Content scripts avec sync host

B2B / Organizations → Utilisez clerk-orgs

• Apps multi-tenant
• Slugs d'organisation dans les URLs
• Rôles, permissions, RBAC
• Gestion des membres

Billing & Subscriptions → Utilisez clerk-billing

• Composant <PricingTable />
• Plan et feature gating avec has()
• Billing B2B basé sur les sièges avec organisations
• Webhooks du cycle de vie des souscriptions
• Essais gratuits, facturation

Webhooks → Utilisez clerk-webhooks

• Événements en temps réel
• Synchronisation des données
• Notifications & intégrations

E2E Testing → Utilisez clerk-testing

• Setup Playwright/Cypress
• Test des flux d'authentification
• Utilitaires de test

Swift / native iOS auth → Utilisez clerk-swift

• Projets natifs iOS Swift et SwiftUI
• Guide d'implémentation ClerkKit et ClerkKitUI
• Patterns source-driven depuis clerk-ios

Android / native mobile auth → Utilisez clerk-android

• Projets natifs Android Kotlin et Jetpack Compose
• Guide d'implémentation clerk-android-api et clerk-android-ui
• Patterns source-driven depuis clerk-android
• Ne pas utiliser pour les projets Expo ou React Native

Backend REST API → Utilisez clerk-backend-api

• Parcourir les tags et endpoints API
• Inspecter les schémas d'endpoints
• Exécuter les requêtes API avec application des scopes

Navigation rapide

Si vous connaissez votre tâche, vous pouvez accéder directement à :

• /clerk-setup - Setup du framework
• /clerk-cli - Opérations CLI et gestion des ressources Clerk
• /clerk-custom-ui - Flux personnalisés & apparence
• /clerk-nextjs-patterns - Patterns Next.js
• /clerk-react-patterns - Patterns React
• /clerk-react-router-patterns - Patterns React Router
• /clerk-vue-patterns - Patterns Vue
• /clerk-nuxt-patterns - Patterns Nuxt
• /clerk-astro-patterns - Patterns Astro
• /clerk-tanstack-patterns - Patterns TanStack Start
• /clerk-expo - Expo / React Native
• /clerk-chrome-extension-patterns - Patterns Chrome Extension
• /clerk-orgs - Organizations
• /clerk-billing - Billing & subscriptions
• /clerk-webhooks - Webhooks
• /clerk-testing - Testing
• /clerk-swift - Swift/native iOS
• /clerk-android - Native Android
• /clerk-backend-api - Backend REST API

Ou décrivez ce que vous avez besoin et je recommanderai le bon.