clerk-local-dev-loop

# Clerk Local Dev Loop ## Overview Configure an efficient local development workflow with Clerk authentication, including test users, hot reload, and mock auth for unit tests. ## Prerequisites - Clerk SDK installed (`clerk-install-auth` completed) - Development instance created in Clerk Dashboard - Node.js development environment ## Instructions ### Step 1: Configure Development Instance Create a separate Clerk development instance to isolate test data from production. ```bash # .env.local — use test keys (pk_test_ / sk_test_) NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_... CLERK_SECRET_KEY=sk_test_... # Optional: Enable Clerk debug logging CLERK_DEBUG=true ``` Clerk development instances provide: - No email verification required - Test phone numbers accepted - Relaxed rate limits - OAuth with test credentials ### Step 2: Set Up Test Users ```typescript // scripts/seed-test-users.ts import { createClerkClient } from '@clerk/backend' const clerk = createClerkClient({ secretKey: process.env.CLERK_SECRET_KEY! }) async function seedTestUsers() { const users = [ { emailAddress: ['admin@test.com'], password: 'test1234', firstName: 'Admin', lastName: 'User' }, { emailAddress: ['member@test.com'], password: 'test1234', firstName: 'Member', lastName: 'User' }, ] for (const user of users) { try { await clerk.users.createUser(user) console.log(`Created: ${user.emailAddress[0]}`) } catch (err: any) { if (err.status === 422) { conso...