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.