clerk-auth
Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up.
How to use
Zainstaluj pakiet Clerk w swoim projekcie Next.js 14 lub 15 i skonfiguruj zmienne środowiskowe wymagane do połączenia z Clerk API.
Opatrz całą aplikację komponentem ClerkProvider na poziomie root layout, aby zapewnić kontekst autentykacji dla wszystkich podkomponentów.
Utwórz plik middleware.ts w głównym katalogu projektu, używając clerkMiddleware i createRouteMatcher do ochrony wybranych tras — określ, które ścieżki wymagają autentykacji, a które są publiczne.
Dodaj wbudowane komponenty Clerk — SignIn i SignUp — na dedykowanych stronach logowania i rejestracji, lub umieść UserButton w nagłówku do zarządzania sesją użytkownika.
W Server Components uzyskaj dostęp do danych autentykacji za pomocą funkcji auth() (zwraca userId, sessionId, orgId) lub currentUser() (zwraca pełny obiekt użytkownika) — oba wymagają skonfigurowanego clerkMiddleware.
Przejrzyj sekcję Sharp Edges w dokumentacji, aby uniknąć znanych problemów i zastosować rekomendowane rozwiązania dla przypadków krytycznych i wysokiego priorytetu.