auth-setup

Set up token-based authentication and user mapping for Convex apps.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/tradewinds-center/rabbithole --skill auth-setup-tradewinds-center
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auth-setup
Source: https://github.com/tradewinds-center/rabbithole/tree/main/.claude/plugins/convex/skills/auth-setup
Command: npx skills add https://github.com/tradewinds-center/rabbithole --skill auth-setup-tradewinds-center

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex authentication setup and user management patterns to securely map identities to your data model, enabling safe admin and user access controls.

Core Features & Use Cases

  • Setup of users table with identity mapping and token-based auth
  • Helper functions to get current user, enforce admin or owner access
  • Example patterns for resource ownership and team-based access
  • Supports various providers (JWT, WorkOS, Auth0) and OAuth flows

Quick Start

Integrate this auth setup by adding a users table, implementing getCurrentUser, and wiring sign-in flows.

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

Convex authentication requires a users table with tokenIdentifier mapping, a getCurrentUser helper function, and a storeUser pattern to capture identity on first sign-in.

What is token-based identity mapping for secure backend access?

Token-based identity mapping links provider tokens to application users via a tokenIdentifier, enabling robust access checks and secure data retrieval across client and backend environments.

Does Convex auth setup support Auth0 and WorkOS?

Yes, this Convex auth setup supports various identity providers including Auth0, WorkOS, and JWT tokens to handle OAuth flows and secure user identity mapping.

How do I enforce admin roles and resource ownership in Convex?

Enforce admin roles and resource ownership in Convex by implementing helper functions that check user roles and verify team-based access before returning sensitive data.

What is the best way to store users on first sign-in with Convex?

The best way to store users on first sign-in is the storeUser pattern, which checks if a tokenIdentifier exists and creates a new user record if absent.