Aller au contenu
TakoAPI
Retour aux skills

sr-next-clerk-expert

par michaelmonetized

Web & Frontend Development
—Pas encore noté
Ta note

Ré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

ENTRÉE

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

AGENT
  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

SORTIE

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-expert

Exécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.

Liens