auth-patterns

Skill do pracy z autentykacją w Next.js. Obejmuje konfigurację NextAuth.js (Auth.js) z dostawcami OAuth (GitHub) i poświadczeniami, ochronę tras middleware, zarządzanie sesjami oraz JWT. Zawiera gotowe przykłady kodu do szybkiego wdrożenia logowania, autoryzacji i kontroli dostępu w aplikacjach Next.js.

1. Zainstaluj NextAuth.js v5 poleceniem npm install next-auth@beta w swoim projekcie Next.js.

2. Utwórz plik auth.ts w głównym katalogu projektu i skonfiguruj NextAuth z wybranymi dostawcami — możesz użyć GitHub OAuth, poświadczeń (email/hasło) lub obu jednocześnie. Dodaj funkcję authorize do weryfikacji użytkownika i ustaw callback authorized do sprawdzenia sesji.

3. Utwórz plik route.ts w ścieżce app/api/auth/[...nextauth]/ i wyeksportuj handlery GET i POST z konfiguracji auth.ts — to obsługuje wszystkie żądania autentykacji.

4. Dodaj middleware.ts w głównym katalogu, aby chronić wybrane trasy. Middleware automatycznie sprawdzi sesję i przekieruje niezalogowanych użytkowników na stronę logowania.

5. W komponentach używaj funkcji signIn i signOut z konfiguracji do obsługi logowania i wylogowania. Dostęp do danych sesji uzyskaj poprzez funkcję auth() w komponentach serwerowych.

6. Jeśli potrzebujesz alternatywy — skill zawiera informacje o Clerk, Lucia, Supabase Auth i niestandardowych JWT jako opcjach dla różnych przypadków użycia.