auth-setup

Automate Convex authentication setup with user tables, identity mapping, and access controls.

1|1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/LucaDeLeo/ASTN --skill auth-setup-lucadeleo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: auth-setup
Source: https://github.com/LucaDeLeo/ASTN/tree/main/.claude/skills/auth-setup
Command: npx skills add https://github.com/LucaDeLeo/ASTN --skill auth-setup-lucadeleo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Set up Convex authentication with proper user management, identity mapping, and access control patterns for consistent security across client and server.

Core Features & Use Cases

  • Architecture overview: client authentication and backend identity mapping for robust access control.
  • Schema Setup: define a users table with a tokenIdentifier index and helper functions to fetch the current user.
  • Core workflows: getCurrentUser, storeUser for first sign-in, authentication checks, authorization guards, and clear error messages.

Quick Start

Sign in a user and invoke the storeUser mutation to create or update the user record on first sign-in.

Frequently Asked Questions about auth-setup

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

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

Setting up authentication in a Convex application involves provisioning a users table with a tokenIdentifier index, configuring client-side OAuth providers, and implementing a storeUser mutation to map identities on first sign-in.

What is backend identity mapping for secure user management?▼

Backend identity mapping for secure user management is the process of linking client authentication tokens to server-side user records via a tokenIdentifier index, enabling consistent access control across client and backend environments.

Can I use OAuth providers and admin roles with Convex auth?▼

Yes, you can use OAuth providers and admin roles with Convex auth. The configuration supports external identity providers, administrative privileges, and authorization guards to protect backend operations.

What's the best way to implement access controls and authorization guards in Convex?▼

The best way to implement access controls in Convex is by using a getCurrentUser helper function combined with authorization guards that verify user roles and return clear error messages when permissions are insufficient.

Why does my Convex app need a storeUser mutation on first sign-in?▼

Your Convex app needs a storeUser mutation on first sign-in to automatically create or update the user record in the database, ensuring the backend identity mapping accurately reflects the authenticated client session.