clerk-testing

E2E testing utilities for Clerk authentication flows in Playwright and Cypress. Test auth = isolated session state. Each test needs fresh auth context. Playwright : Use globalSetup for auth state Cypress : Add addClerkCommands({ Cypress, cy }) to support file - Supports both Playwright and Cypress frameworks with framework-specific setup patterns (globalSetup for Playwright, custom commands for Cypress) - Provides clerkSetup() and setupClerkTestingToken() utilities to initialize test environments and bypass bot detection - Includes storageState persistence to reuse authenticated sessions across tests, reducing test execution time - Requires test API keys ( pk_test_* , sk_test_* ) and offers best practices for avoiding common pitfalls like production credentials and repeated UI-based sign-ins - clerkSetup() initializes test environment - setupClerkTestingToken() bypasses bot detection - storageState persists auth between tests for speed - Identify test framework (Playwright or Cypress) - WebFetch the appropriate URL from decision tree above - Follow official setup instructions - Use pk_test_* and sk_test_* keys only - Use setupClerkTestingToken() before navigating to auth pages - Use test API keys: pk_test_xxx , sk_test_xxx - Save auth state with storageState for faster tests - Use page.waitForSelector('[data-clerk-component]') for Clerk UI - clerk-setup - Install Clerk before...