convex-setup-auth

Set up Convex authentication with user management and access control.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ludicroushq/vertex --skill convex-setup-auth-ludicroushq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-setup-auth
Source: https://github.com/ludicroushq/vertex/tree/main/.agents/skills/convex-setup-auth
Command: npx skills add https://github.com/ludicroushq/vertex --skill convex-setup-auth-ludicroushq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Sets up Convex authentication with user management, identity mapping, and access control.

Core Features & Use Cases

  • Create and map users to identities
  • Wire Convex auth provider and protect data
  • Use cases: add login/signup, gate queries, and enforce authorization

Quick Start

Choose an auth provider, run the Convex setup, and wire the provider into your app to protect data.

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 Convex to protect user data?

To set up Convex auth, choose a provider like Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT, then wire convex/auth.config.ts and use ctx.auth.getUserIdentity() to gate queries and mutations for secure access control.

What authentication providers work with Convex for identity management?

Convex supports Convex Auth, Clerk, WorkOS AuthKit, Auth0, and custom JWT providers for identity management. Following the Convex Auth docs for your chosen provider allows you to wire convex/auth.config.ts and map users to identities.

How does ctx.auth.getUserIdentity() work for gating access to Convex queries?

The ctx.auth.getUserIdentity() method retrieves the authenticated user's identity within Convex queries and mutations. Guarding data with this method enforces access control, ensuring only verified users can execute protected operations.

Can I use Clerk or Auth0 to add login and signup flows to my Convex app?

Yes, Clerk, Auth0, WorkOS AuthKit, and Convex Auth can add login and signup flows to your app. Wiring your chosen provider into convex/auth.config.ts maps users to identities and enables secure login and signup functionality.

What is identity mapping in Convex auth and when do I need it?

Identity mapping in Convex auth links authenticated identities from your provider to application users. You need it when adding login or signup flows, configuring providers, and gating access to data across your Convex apps.