convex-setup-auth

Automate Convex authentication setup with provider wiring and access control.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/tacticus-tools/tp2-reset --skill convex-setup-auth-tacticus-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-setup-auth
Source: https://github.com/tacticus-tools/tp2-reset/tree/main/.agents/skills/convex-setup-auth
Command: npx skills add https://github.com/tacticus-tools/tp2-reset --skill convex-setup-auth-tacticus-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sets up Convex authentication with user management, identity mapping, and access control for Convex apps, covering login/signup flows, provider wiring, and authorization.

Core Features & Use Cases

  • Chooses an authentication provider (Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT) and wires backend and frontend accordingly.
  • Creates and protects user state via identity mapping and ctx.auth.getUserIdentity(), with role-based access control when required.
  • Supports production-ready considerations and guidance for integration into existing apps with deployment and environment variables.

Quick Start

Choose an auth provider and begin wiring Convex authentication according to the provider's guide.

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 application?

To set up Convex authentication, you choose a provider like Convex Auth, Clerk, Auth0, or custom JWT, then wire the backend and frontend accordingly. It configures deployment environment variables and login flows.

How do I protect Convex queries and mutations with user identity?

Protect Convex queries by calling ctx.auth.getUserIdentity() inside backend functions. This maps user identities and enforces access control to secure application state.

Can I use Clerk or Auth0 for login flows with a Convex backend?

Yes, you can use Clerk or Auth0 with a Convex backend. The setup wires these external providers into your frontend and backend, mapping their identities into your Convex application for authentication.

What is the best way to manage app-level users and roles in Convex?

App-level users and roles in Convex are managed through identity mapping and optional role-based access control. Storing user state alongside mapped identities enforces granular permissions within queries and mutations.

Does Convex authentication require a configured deployment before wiring login?

Yes, a configured Convex deployment is required before wiring login. The setup ensures your deployment and environment variables are prepared to support the chosen auth provider and access control.