convex-setup-auth

Configure Convex authentication with provider wiring and identity-based access control.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MarcoDava/MockCortex --skill convex-setup-auth-marcodava
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-setup-auth
Source: https://github.com/MarcoDava/MockCortex/tree/main/frontend/.agents/skills/convex-setup-auth
Command: npx skills add https://github.com/MarcoDava/MockCortex --skill convex-setup-auth-marcodava

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sets up Convex authentication with user management, identity mapping, and access control to enable login, authorization, and protected data access in Convex apps.

Core Features & Use Cases

  • Flexible provider selection: Guides choosing between Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWTs, and wires the provider accordingly.
  • Backend and UI wiring: Creates or updates convex.auth.config.ts, wires a provider wrapper, and applies ctx.auth.getUserIdentity() guards on protected queries and mutations.
  • Optional app-level user storage: Adds a users table and identity mapping only if the app requires first-class user data.

Quick Start

Choose a provider and wire up Convex auth configuration and access control in your app.

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 an auth provider, wire the auth flow in convex/auth.config.ts, and apply ctx.auth.getUserIdentity() guards on protected queries and mutations.

Can I use Clerk or Auth0 for login with Convex?

Yes, Convex authentication supports wiring external providers including Clerk, WorkOS AuthKit, Auth0, or custom JWTs to manage login and identity mapping.

What is the best way to protect Convex queries from unauthorized access?

The best way to protect Convex queries is by implementing backend identity checks using ctx.auth.getUserIdentity() to enforce access control on protected data.

Do I need a users table for identity mapping in Convex Auth?

You only need a users table for identity mapping if your app requires first-class user data storage alongside the default Convex Auth provider configuration.

Does Convex authentication support role-based access control?

Yes, Convex authentication enables role-based access by implementing identity mapping and applying backend identity checks to restrict protected queries and mutations.