clerk-hello-world
Pierwszy uwierzytelniony request z Clerk — przetestuj integrację od razu
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do tworzenia pierwszego uwierzytelnionego żądania API z Clerk. Użyj go, aby przetestować, czy Clerk jest poprawnie skonfigurowany w Twojej aplikacji — zarówno w komponentach serwera, komponentach klienta, trasach API, jak i akcjach serwera. Waliduje całą integrację end-to-end i pomaga zweryfikować, że zmienne środowiskowe, middleware i ClerkProvider działają prawidłowo.
Jak używać
Upewnij się, że masz zainstalowany Clerk SDK (skill clerk-install-auth powinien być już uruchomiony) i skonfigurowane zmienne środowiskowe: NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY oraz CLERK_SECRET_KEY.
Sprawdź, czy ClerkProvider otacza root Twojej aplikacji i middleware jest skonfigurowany w katalogu głównym projektu.
W komponencie serwera (np. app/dashboard/page.tsx) użyj funkcji auth() do pobrania userId z sesji — jest to lekkie i nie wymaga dodatkowego API call. Jeśli userId nie istnieje, przekieruj użytkownika na stronę logowania.
Jeśli potrzebujesz pełnych danych użytkownika (imię, email, datę utworzenia), użyj currentUser() — pamiętaj, że ta funkcja wykonuje Backend API call i liczy się do limitu zapytań, więc używaj jej oszczędnie.
Wyzwól skill frazami takimi jak "clerk hello world", "first clerk request", "test clerk auth" lub "verify clerk setup", aby automatycznie wygenerować kod testowy.
Uruchom aplikację i sprawdź, czy dashboard wyświetla poprawnie dane użytkownika — to potwierdzenie, że cała integracja Clerk działa prawidłowo.