clerk-sdk-patterns

Skill zawiera sprawdzone wzorce implementacji Clerk SDK dla Next.js i React. Obejmuje autentykację po stronie serwera i klienta, dostęp do danych użytkownika, sprawdzanie uprawnień oraz integrację metod SDK w middleware. Użyj go, gdy implementujesz przepływy logowania, pobierasz profil użytkownika lub weryfikujesz dostęp do zasobów. Wyzwól słowami kluczowymi: "clerk SDK", "clerk patterns", "clerk best practices" lub "clerk API usage".

1. Upewnij się, że masz zainstalowany Clerk SDK i skonfigurowany ClerkProvider owijający całą aplikację. Skill wymaga podstawowej wiedzy o React i Next.js.

2. Dla autentykacji po stronie serwera (Server Components) użyj funkcji auth() z @clerk/nextjs/server do szybkich sprawdzeń tożsamości i uprawnień. Funkcja zwraca userId, orgId i metodę has() do weryfikacji permisji.

3. Gdy potrzebujesz pełnych danych profilu użytkownika, użyj currentUser() zamiast auth(). Zwraca kompletny obiekt użytkownika z firstName, lastName, emailAddresses i imageUrl.

4. Po stronie klienta (Client Components) korzystaj z hooków useUser, useAuth, useClerk i useSignIn z @clerk/nextjs. Skill zawiera przykłady ich zastosowania w komponentach oznaczonych 'use client'.

5. Wyzwól skill pytaniami lub poleceniami zawierającymi frazy takie jak "clerk SDK", "clerk patterns", "clerk best practices" lub "clerk API usage". Skill dostarczy odpowiedni wzorzec kodu dla Twojego przypadku użycia.

6. Skill obsługuje operacje Read, Write, Edit i Grep, więc możesz go użyć do przeglądania istniejącego kodu, generowania nowych implementacji lub modyfikowania istniejących rozwiązań.