setup-convex

Integrate Sigma Auth OAuth into Convex applications with Better Auth plugins.

Updated Nov 16, 2025
One-click install
npx skills add https://github.com/b-open-io/better-auth-plugin --skill setup-convex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-convex
Source: https://github.com/b-open-io/better-auth-plugin/tree/main/skills/setup-convex
Command: npx skills add https://github.com/b-open-io/better-auth-plugin --skill setup-convex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the integration of Sigma Auth, a Bitcoin-native authentication solution, into Convex applications, streamlining the setup process for developers.

Core Features & Use Cases

  • Convex Integration: Provides step-by-step guidance for wiring up Better Auth with Convex.
  • Environment Configuration: Details necessary environment variables for both Next.js and Convex deployments.
  • Use Case: A developer building a new web application using Convex and Next.js needs to implement secure, Bitcoin-native authentication. This Skill guides them through installing dependencies, configuring Convex components, setting up API routes, and client-side authentication flows.

Quick Start

Follow the installation and configuration steps to integrate Sigma Auth into your Convex application.

Frequently Asked Questions about setup-convex

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

FAQPage Schema
How do I integrate Sigma Auth OAuth into a Convex application?

To integrate Sigma Auth OAuth into a Convex application, install the @sigma-auth/better-auth-plugin and @convex-dev/better-auth packages, register the Convex components, and configure environment variables for Next.js and Convex CLI. You then set up server-side configuration using sigmaCallbackPlugin and proxy the Next.js auth handler.

How does Bitcoin-native authentication work with Better Auth and Convex?

Bitcoin-native authentication with Better Auth and Convex works by using the @sigma-auth/better-auth-plugin to manage OAuth flows. It requires configuring server-side sigmaCallbackPlugin settings, proxying Next.js API routes, and setting up the Convex provider to handle client-side authentication state.

What environment variables do I need to configure for Sigma Auth and Convex?

You need to configure specific environment variables for both Next.js and the Convex CLI to enable Sigma Auth. Proper environment variable management is a critical deployment checklist item to ensure the authentication flow functions correctly across your application components.

Can I install admin and organization plugins locally with Better Auth in Convex?

Yes, you can install admin and organization plugins locally when integrating Better Auth with Convex. The setup process includes local installation for these plugins, running schema generation, and following a critical deployment checklist for route protection.

What are the deployment checklist items for Convex route protection with Better Auth?

The deployment checklist for Convex route protection includes verifying environment variable management and ensuring proper server-side configuration. You must also confirm that your Next.js auth handler proxying and client-side Convex provider setup are correctly applied to protect routes.