sr-next-clerk-expert
par michaelmonetized
Web & Frontend DevelopmentRésumé
Senior-level Clerk authentication expertise for Next.js 15/16+ applications.
Description
Ce que fait ce skill
Provides senior-level patterns for implementing Clerk authentication in Next.js 15/16+ apps. Covers route protection, middleware configuration, client vs server auth boundaries, and integration with Convex and Stripe. Includes a set of rules that prevent common auth failures like 500 errors, infinite redirects, and handshake loops.
Encodes hard-won production rules that are not obvious from Clerk's official docs, preventing outages caused by calling auth() on public pages or skipping ClerkLoaded wrappers.
Quand l'utiliser
- Protecting dashboard routes while keeping marketing pages public
- Migrating from middleware.ts to proxy.ts for Next.js 16+
- Debugging Clerk handshake redirects and 500 errors in production
- Adding Stripe billing flows to an existing Clerk-authenticated app
- Syncing Clerk users to a Convex database via webhooks
Exemple de workflow
User asks: How do I protect my dashboard routes but keep the homepage public in Next.js 16+?
- 1
Creates app/(private)/ route group containing dashboard and settings pages
- 2
Generates proxy.ts using clerkMiddleware that only protects /(private)(.*) routes
- 3
Creates app/(private)/layout.tsx that calls auth() and redirects unauthenticated users
- 4
Updates app/page.tsx to use SignedIn/SignedOut inside ClerkLoaded instead of calling auth()
- 5
Provides verification checklist to test anonymous access before deploying
Working route protection setup where public pages remain static and only private routes require authentication
Prérequis
- CLERK_SECRET_KEY environment variable (from Clerk Dashboard)
- NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY environment variable (from Clerk Dashboard)
- Clerk account
Installation
clawhub install michaelmonetized/sr-next-clerk-expertExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.