convex-setup-auth

Configure Convex authentication with provider wiring and identity checks.

2|Updated Jul 1, 2025
One-click install
npx skills add https://github.com/RinKhimera/NOMAQbanq --skill convex-setup-auth-rinkhimera
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-setup-auth
Source: https://github.com/RinKhimera/NOMAQbanq/tree/main/.agents/skills/convex-setup-auth
Command: npx skills add https://github.com/RinKhimera/NOMAQbanq --skill convex-setup-auth-rinkhimera

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configures and wires Convex authentication across a Convex app, including user management, identity mapping, and access control.

Core Features & Use Cases

  • Supports multiple providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT) and sets up the required wiring.
  • Protects backend functions and UI with server-side identity checks using ctx.auth.getUserIdentity().
  • Creates or maps a users identity table as needed and configures role-based access control for common admin/user scenarios.

Quick Start

Provide a secure Convex auth setup by selecting a provider and wiring up the authentication flow.

Frequently Asked Questions about convex-setup-auth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up authentication in a Convex app?▼

To set up Convex authentication, you select a provider like Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT, then wire it by configuring the auth provider in convex/auth.config.ts and adding necessary environment variables.

How do I protect backend functions with access control in Convex?▼

You protect backend functions in Convex by implementing server-side identity checks using ctx.auth.getUserIdentity() to verify authenticated users and enforce role-based access control for admin or user scenarios.

Which auth providers work with Convex for login and signup flows?▼

Convex supports Convex Auth, Clerk, WorkOS AuthKit, Auth0, and custom JWT providers for login and signup flows. Each requires specific wiring in convex/auth.config.ts and environment variable configuration.

Do I need to create a separate user storage table when using Convex auth?▼

Optional app-level user storage is supported alongside Convex auth. The setup can create or map a users identity table as needed to manage user data and configure role-based access control.

What is the best way to configure Clerk authentication with Convex backend functions?▼

The best way to configure Clerk with Convex is wiring the provider in convex/auth.config.ts, setting required environment variables, and protecting backend functions via ctx.auth.getUserIdentity() for secure identity mapping.

Why does my custom JWT provider not work with Convex auth?▼

Custom JWT Convex auth requires correct provider wiring in convex/auth.config.ts and properly configured environment variables. Production-ready considerations must be applied to ensure identity mapping and access control function correctly.