convex-auth

Manage user authentication and authorization in Convex applications with @convex-dev/auth.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/Geolize/convex-skills --skill convex-auth-geolize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-auth
Source: https://github.com/Geolize/convex-skills/tree/main/skills/convex-auth
Command: npx skills add https://github.com/Geolize/convex-skills --skill convex-auth-geolize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a robust and secure way to handle user authentication, management, and authorization within Convex applications, ensuring only legitimate users can access protected resources.

Core Features & Use Cases

  • User Authentication: Integrates with @convex-dev/auth for seamless login and logout flows.
  • Protected Routes: Enables the creation of functions and endpoints accessible only to authenticated users.
  • User Data Management: Provides patterns for schema definition, user table extension, and accessing user information.
  • Use Case: Securely manage user sign-ups, log-ins, and protect sensitive data like user profiles and posts using Convex's built-in authentication utilities.

Quick Start

Use the convex-auth skill to get the current logged-in user's data on the frontend.

Frequently Asked Questions about convex-auth

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

FAQPage Schema
How do I add user authentication to my Convex application?

You can protect Convex mutations, queries, scheduled jobs, and HTTP endpoints by validating user identity before execution. This skill provides patterns to ensure only authenticated users access sensitive application data.

Does this approach support custom user roles and preferences in the database schema?

Yes, the authentication schema supports extending user tables with custom fields for roles and preferences. This allows you to manage user data and authorization levels directly within your Convex database structure.

Can I access the logged-in user's data on the frontend after authentication?

Yes, user identity propagation is supported across scheduled jobs and HTTP endpoints in Convex. This ensures secure user authorization and session handling persist throughout background tasks and external API requests.

What is the best way to manage user sessions and secure resources in Convex?

The best way to manage user sessions in Convex is using the @convex-dev/auth library for secure login and logout flows. It handles session management and ensures only legitimate users access protected resources.