clerk-local-dev-loop

Umożliwia szybkie przygotowanie środowiska deweloperskiego z Clerk authentication. Automatyzuje konfigurację instancji testowej, tworzenie użytkowników testowych i ustawienie hot reload. Idealne do testowania logowania lokalnie, izolowania danych testowych od produkcji i mockowania autentykacji w testach jednostkowych. Pracuje z Node.js i wspiera npm oraz pnpm.

1. Upewnij się, że masz zainstalowany Clerk SDK (poprzez skill clerk-install-auth) i utworzoną instancję deweloperską w panelu Clerk Dashboard.

2. Utwórz plik .env.local w głównym katalogu projektu i dodaj klucze testowe z Clerk (zaczynające się od pk_test_ i sk_test_). Opcjonalnie włącz CLERK_DEBUG=true, aby zobaczyć logi debugowania.

3. Utwórz skrypt seed-test-users.ts w katalogu scripts, który będzie tworzyć użytkowników testowych przy użyciu Clerk SDK. Skrypt powinien zawierać co najmniej dwóch użytkowników testowych (np. admin i member) z hasłami testowymi.

4. Uruchom skrypt seedujący z linii poleceń (npm run seed lub pnpm seed), aby załadować użytkowników testowych do instancji deweloperskiej.

5. Skonfiguruj hot reload w swoim środowisku (np. Next.js dev server) – instancja testowa Clerk obsługuje automatyczne przeładowanie bez weryfikacji email i z łagodnymi limitami ratingu.

6. Zacznij testować logowanie lokalnie, korzystając z utworzonych użytkowników testowych. Instancja testowa akceptuje numery telefonów testowych i umożliwia testowanie OAuth z fikcyjnymi poświadczeniami.