auth-setup

Installation
Summary

Convex authentication setup with provider selection, user management, and access control patterns.

  • Supports multiple auth providers: Convex Auth, Clerk, WorkOS AuthKit, Auth0, and custom JWT, with provider detection from repo signals before setup
  • Guides identity mapping to a users table, getCurrentUser helpers, and authorization patterns for ownership, admin, and team access checks
  • Includes provider-specific reference files for package installation, environment variables, client wiring, and convex/auth.config.ts configuration
  • Covers both local-only and production-ready setup workflows with validation checklists for login state, protected queries, and environment configuration
SKILL.md

Convex Authentication Setup

Implement secure authentication in Convex with user management and access control.

When to Use

  • Setting up authentication for the first time
  • Implementing user management (users table, identity mapping)
  • Creating authentication helper functions
  • Setting up auth providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, custom JWT)

First Step: Choose the Auth Provider

Convex supports multiple authentication approaches. Do not assume a provider.

Before writing setup code:

  1. Ask the user which auth solution they want, unless the repository already makes it obvious
  2. If the repo already uses a provider, continue with that provider unless the user wants to switch
Related skills
Installs
514
GitHub Stars
27
First Seen
Feb 18, 2026