clerk

Routeur d'authentification Clerk. À utiliser quand l'utilisateur demande comment ajouter une authentification,

npx skills add https://github.com/clerk/skills --skill clerk

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-api et clerk-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.

Skills similaires