تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

sr-next-clerk-expert

بواسطة michaelmonetized

Web & Frontend Development
—لم يُقيَّم بعد
تقييمك

موجز

Senior-level Clerk authentication expertise for Next.js 15/16+ applications.

الوصف

ما الذي تفعله هذه المهارة

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.

متى تستخدمها

  • 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

مثال على سير العمل

الإدخال

User asks: How do I protect my dashboard routes but keep the homepage public in Next.js 16+?

الوكيل
  1. 1

    Creates app/(private)/ route group containing dashboard and settings pages

  2. 2

    Generates proxy.ts using clerkMiddleware that only protects /(private)(.*) routes

  3. 3

    Creates app/(private)/layout.tsx that calls auth() and redirects unauthenticated users

  4. 4

    Updates app/page.tsx to use SignedIn/SignedOut inside ClerkLoaded instead of calling auth()

  5. 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

المتطلبات

  • CLERK_SECRET_KEY environment variable (from Clerk Dashboard)
  • NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY environment variable (from Clerk Dashboard)
  • Clerk account

التثبيت

clawhub install michaelmonetized/sr-next-clerk-expert

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط