sr-next-clerk-expert
bởi michaelmonetized
Web & Frontend DevelopmentTóm tắt
Senior-level Clerk authentication expertise for Next.js 15/16+ applications.
Mô tả
Kỹ năng này làm gì
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.
Khi nào nên dùng
- 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
Quy trình ví dụ
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
Yêu cầu
- CLERK_SECRET_KEY environment variable (from Clerk Dashboard)
- NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY environment variable (from Clerk Dashboard)
- Clerk account
Cài đặt
clawhub install michaelmonetized/sr-next-clerk-expertChạy lệnh CLI, hoặc dán prompt vào Claude Code, Cursor, Codex hay coding agent bạn đang dùng.