sr-next-clerk-expert
michaelmonetized tarafından
Web & Frontend DevelopmentÖzet
Senior-level Clerk authentication expertise for Next.js 15/16+ applications.
Açıklama
Bu Beceri Ne Yapar
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.
Ne Zaman Kullanılır
- 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
Örnek İş Akışı
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
Gereksinimler
- CLERK_SECRET_KEY environment variable (from Clerk Dashboard)
- NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY environment variable (from Clerk Dashboard)
- Clerk account
Kurulum
clawhub install michaelmonetized/sr-next-clerk-expertCLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.