clerk-auth

Zbiór sprawdzonych wzorców do szybkiej integracji autentykacji Clerk w aplikacjach Next.js 14/15. Zawiera konfigurację ClerkProvider, komponenty logowania i rejestracji, ochronę tras middleware oraz dostęp do danych użytkownika w Server Components. Idealne gdy dodajesz system logowania, zarządzania sesjami lub obsługę organizacji w swoim projekcie.

1. Zainstaluj pakiet Clerk w swoim projekcie Next.js 14 lub 15 i skonfiguruj zmienne środowiskowe wymagane do połączenia z Clerk API.

2. Opatrz całą aplikację komponentem ClerkProvider na poziomie root layout, aby zapewnić kontekst autentykacji dla wszystkich podkomponentów.

3. 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.

4. 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.

5. 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.

6. Przejrzyj sekcję Sharp Edges w dokumentacji, aby uniknąć znanych problemów i zastosować rekomendowane rozwiązania dla przypadków krytycznych i wysokiego priorytetu.