setup-convex

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

Updated Nov 16, 2025

Search Tags:#authentication #oauth #better-auth #next.js #convex #bitcoin #sigma auth

Ready to run

npx skills add https://github.com/b-open-io/better-auth-plugin --skill setup-convex

💬 Prompt for ChatGPT / Claude Chat▼

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.