clerk-auth

Automation & Intégrations

"Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up."

Documentation

Clerk Authentication

Patterns

Next.js App Router Setup

Complete Clerk setup for Next.js 14/15 App Router.

Includes ClerkProvider, environment variables, and basic

sign-in/sign-up components.

Key components:

●ClerkProvider: Wraps app for auth context
●, : Pre-built auth forms
●: User menu with session management

Middleware Route Protection

Protect routes using clerkMiddleware and createRouteMatcher.

Best practices:

●Single middleware.ts file at project root
●Use createRouteMatcher for route groups
●auth.protect() for explicit protection
●Centralize all auth logic in middleware

Server Component Authentication

Access auth state in Server Components using auth() and currentUser().

Key functions:

●auth(): Returns userId, sessionId, orgId, claims
●currentUser(): Returns full User object
●Both require clerkMiddleware to be configured

⚠️ Sharp Edges

| Issue | Severity | Solution |

|-------|----------|----------|

| Issue | critical | See docs |

| Issue | high | See docs |

| Issue | high | See docs |

| Issue | high | See docs |

| Issue | medium | See docs |

| Issue | medium | See docs |

| Issue | medium | See docs |

| Issue | medium | See docs |

Utiliser l'Agent clerk-auth - Outil & Compétence IA | Skills Catalogue | Skills Catalogue