Routeur de Skills Clerk
Détection de version
Vérifiez package.json pour déterminer la version du SDK Clerk. Cela détermine les modèles à utiliser :
| Package | Core 2 (LTS jusqu'à jan 2027) | Current |
|---|---|---|
@clerk/nextjs |
v5–v6 | v7+ |
@clerk/react ou @clerk/clerk-react |
v5–v6 | v7+ |
@clerk/expo ou @clerk/clerk-expo |
v1–v2 | v3+ |
@clerk/react-router |
v1–v2 | v3+ |
@clerk/tanstack-react-start |
< v0.26.0 | v0.26.0+ |
Utilisez par défaut 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 encadrés > **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 puisque ces API sont entièrement différentes selon les versions.
Par tâche
Ajouter Clerk à votre projet → Utilisez clerk-setup
- Détection du framework et démarrage rapide
- Configuration de l'environnement, clés API, flux Keyless
- Migration depuis d'autres fournisseurs d'authentification
Interface d'inscription/connexion personnalisée → Utilisez clerk-custom-ui
- Flux d'authentification personnalisés avec les hooks
useSignIn/useSignUp - Apparence et styles (thèmes, couleurs, mise en page)
- Composant
<Show>pour le rendu conditionnel
Modèles avancés Next.js → Utilisez clerk-nextjs-patterns
- APIs d'authentification serveur vs client
- Stratégies middleware
- Server Actions, mise en cache
- Protection des routes API
Modèles React → Utilisez clerk-react-patterns
- Hooks (
useAuth,useUser,useClerk) - Routes protégées, gardes d'authentification
- Intégration routeur
Modèles React Router → Utilisez clerk-react-router-patterns
- Loaders & actions avec authentification
- Protection des routes
- Auth SSR
Modèles Vue → Utilisez clerk-vue-patterns
- Composables (
useAuth,useUser,useClerk) - Gardes Vue Router
- Intégration store Pinia
Modèles Nuxt → Utilisez clerk-nuxt-patterns
- Middleware serveur avec authentification
- Auth SSR avec composables
- Routes API serveur
Modèles Astro → Utilisez clerk-astro-patterns
- Pages SSR avec authentification
- Composants Island avec React
- Middleware & routes API
Modèles TanStack Start → Utilisez clerk-tanstack-patterns
- Fonctions serveur avec authentification
- Protection des routes via loaders
- Intégration serveur Vinxi
Modèles Expo → Utilisez clerk-expo-patterns
- Stockage sécurisé des tokens
- Deep linking OAuth
- Notifications push avec authentification
Modèles Chrome Extension → Utilisez clerk-chrome-extension-patterns
- Auth des scripts de fond
- Flux auth popup
- Scripts de contenu avec synchronisation d'hôte
B2B / Organizations → Utilisez clerk-orgs
- Applications multi-tenant
- Slugs d'organisation dans les URLs
- Rôles, permissions, RBAC
- Gestion des membres
Facturation & Abonnements → Utilisez clerk-billing
- Composant
<PricingTable /> - Portage de plans et fonctionnalités avec
has() - Facturation B2B basée sur les sièges avec organizations
- Webhooks du cycle de vie des abonnements
- Essais gratuits, facturation
Webhooks → Utilisez clerk-webhooks
- Événements en temps réel
- Synchronisation des données
- Notifications & intégrations
Tests E2E → Utilisez clerk-testing
- Configuration Playwright/Cypress
- Test des flux d'authentification
- Utilitaires de test
Swift / authentification iOS native → Utilisez clerk-swift
- Projets Swift et SwiftUI iOS natifs
- Conseils d'implémentation ClerkKit et ClerkKitUI
- Modèles pilotés par la source depuis
clerk-ios
Android / authentification mobile native → Utilisez clerk-android
- Projets Kotlin et Jetpack Compose Android natifs
- Conseils d'implémentation
clerk-android-apietclerk-android-ui - Modèles pilotés par la source depuis
clerk-android - N'utilisez pas pour les projets Expo ou React Native
API REST Backend → Utilisez clerk-backend-api
- Parcourir les tags et endpoints API
- Inspecter les schémas d'endpoint
- 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- Configuration du framework/clerk-custom-ui- Flux personnalisés & apparence/clerk-nextjs-patterns- Modèles Next.js/clerk-react-patterns- Modèles React/clerk-react-router-patterns- Modèles React Router/clerk-vue-patterns- Modèles Vue/clerk-nuxt-patterns- Modèles Nuxt/clerk-astro-patterns- Modèles Astro/clerk-tanstack-patterns- Modèles TanStack Start/clerk-expo-patterns- Modèles Expo/clerk-chrome-extension-patterns- Modèles Chrome Extension/clerk-orgs- Organizations/clerk-billing- Facturation & abonnements/clerk-webhooks- Webhooks/clerk-testing- Tests/clerk-swift- Swift/iOS natif/clerk-android- Android natif/clerk-backend-api- API REST Backend
Ou décrivez ce dont vous avez besoin et je recommanderai le bon.