Open Skills Logo
Open Skills

clerk-auth

Clerk认证实现、中间件、组织管理、Webhooks及用户同步的专家模式应用场景：适用于添加身份验证、Clerk认证、用户鉴权、登录与注册功能时使用。

查看详情
name:clerk-authdescription:"Expert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authentication, sign in, sign up."source:vibeship-spawner-skills (Apache 2.0)

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

    IssueSeveritySolution
    IssuecriticalSee docs
    IssuehighSee docs
    IssuehighSee docs
    IssuehighSee docs
    IssuemediumSee docs
    IssuemediumSee docs
    IssuemediumSee docs
    IssuemediumSee docs