Better Auth

better-auth.com

Developer Tools

The most comprehensive authentication library for TypeScript.

llms.txt

Better Auth

The most comprehensive authentication framework for TypeScript

Adapters

Community Adapters: Community-built database adapters that extend Better Auth.
Drizzle ORM Adapter: Integrate Better Auth with Drizzle ORM.
MongoDB Adapter: Integrate Better Auth with MongoDB.
MS SQL: Integrate Better Auth with MS SQL.
MySQL: Integrate Better Auth with MySQL.
Other Relational Databases: Integrate Better Auth with other relational databases.
PostgreSQL: Integrate Better Auth with PostgreSQL.
Prisma: Integrate Better Auth with Prisma.
SQLite: Integrate Better Auth with SQLite.

Ai Resources

AI Resources: Ask AI in the docs, LLMs.txt, the documentation MCP server, and Better Auth skills for coding assistants.
MCP: Connect Better Auth documentation to MCP-capable clients via the remote documentation MCP server.
Skills: Install Better Auth agent skills so your coding assistant follows library conventions and patterns.

Authentication

Apple: Apple provider setup and usage.
Atlassian: Atlassian provider setup and usage.
Cognito: Amazon Cognito provider setup and usage.
Discord: Discord provider setup and usage.
Dropbox: Dropbox provider setup and usage.
Email & Password: Implementing email and password authentication with Better Auth.
Facebook: Facebook provider setup and usage.
Figma: Figma provider setup and usage.
GitHub: GitHub provider setup and usage.
GitLab: GitLab provider setup and usage.
Google: Google provider setup and usage.
Hugging Face: Hugging Face provider setup and usage.
Kakao: Kakao provider setup and usage.
Kick: Kick provider setup and usage.
LINE: LINE provider setup and usage.
Linear: Linear provider setup and usage.
LinkedIn: LinkedIn Provider
Microsoft: Microsoft provider setup and usage.
Naver: Naver provider setup and usage.
Notion: Notion provider setup and usage.
Other Social Providers: Other social providers setup and usage.
Paybin: Paybin provider setup and usage.
PayPal: Paypal provider setup and usage.
Polar: Polar provider setup and usage.
Railway: Railway provider setup and usage.
Reddit: Reddit provider setup and usage.
Roblox: Roblox provider setup and usage.
Salesforce: Salesforce provider setup and usage.
Slack: Slack provider setup and usage.
Spotify: Spotify provider setup and usage.
TikTok: TikTok provider setup and usage.
Twitch: Twitch provider setup and usage.
Twitter (X): Twitter provider setup and usage.
Vercel: Vercel provider setup and usage.
VK: VK ID Provider
WeChat: WeChat provider setup and usage.
Zoom: Zoom provider setup and usage.

Basic Usage

Basic Usage: Getting started with Better Auth

Comparison

Comparison: Comparison of Better Auth versus over other auth libraries and services.

Concepts

API: Learn how to call Better Auth API endpoints on the server, pass body, headers, and query parameters, retrieve response headers, and handle errors.
CLI: Learn about the Better Auth CLI commands for generating and migrating database schemas, initializing projects, generating secret keys, and gathering diagnostic info.
Client: Learn how to set up the Better Auth client for React, Vue, Svelte, and other frameworks, use hooks, configure fetch options, handle errors, and extend with client plugins.
Cookies: Learn how Better Auth uses cookies, including cookie prefixes, custom cookie attributes, cross-subdomain sharing, secure cookies, and handling Safari ITP with proxies.
Database: Learn about database adapters, migrations, secondary storage with Redis, core schema (user, session, account, verification), custom tables, extending schemas, ID generation, database hooks, and plugin schemas.
Email: Learn how to set up email verification, require verified emails for sign-in, auto sign-in after verification, handle post-verification callbacks, and implement password reset emails.
Hooks: Learn how to use before and after hooks to customize endpoint behavior, modify requests and responses, handle cookies, throw errors, access auth context, and run background tasks.
OAuth: Learn how to configure social OAuth providers, sign in and link accounts, request scopes, pass additional data, refresh access tokens, map profiles, and customize provider options.
Plugins: Learn how to use and create Better Auth plugins, including defining endpoints, schemas, hooks, middleware, rate limits, trusted origins, and building client plugins with custom actions and atoms.
Rate Limit: Learn how to configure rate limiting in Better Auth, including IP address detection, IPv6 support, custom rate limit windows, storage backends, error handling, and per-endpoint rules.
Session Management: Learn about session management in Better Auth, including session expiration, freshness, cookie caching strategies, secondary storage, stateless sessions, and customizing session responses.
TypeScript: Learn about TypeScript configuration for Better Auth, including strict mode, inferring types for sessions and users, defining additional fields, and inferring additional fields on the client.
User & Accounts: Learn how to manage users and accounts, including updating user info, changing emails and passwords, deleting users with verification, token encryption, and account linking and unlinking.

Examples

Astro Example: Better Auth Astro example.
Next.js Example: Better Auth Next.js example.
Nuxt Example: Better Auth Nuxt example.
React Router v7 Example: Better Auth React Router v7 example.
SvelteKit Example: Better Auth SvelteKit example.

Guides

Migrating from Auth0 to Better Auth: A step-by-step guide to transitioning from Auth0 to Better Auth.
Browser Extension Guide: A step-by-step guide to creating a browser extension with Better Auth.
Migrating from Clerk to Better Auth: A step-by-step guide to transitioning from Clerk to Better Auth.
Create a Database Adapter: Learn how to create a custom database adapter for Better-Auth
Dynamic Base URL: Configure Better Auth for preview deployments, multiple domains, and per-request URL resolution.
Migrating from Auth.js to Better Auth: A step-by-step guide to transitioning from Auth.js to Better Auth.
Optimizing for Performance: A guide to optimizing your Better Auth application for performance.
SAML SSO with Okta: A guide to integrating SAML Single Sign-On (SSO) with Better Auth, featuring Okta
Migrating from Supabase Auth to Better Auth: A step-by-step guide to transitioning from Supabase Auth to Better Auth.
Migrating from WorkOS to Better Auth: A step-by-step guide to transitioning from WorkOS to Better Auth.
Create your first plugin: A step-by-step guide to creating your first Better Auth plugin.

Infrastructure

Getting Started: This guide will help you integrate Better Auth Infrastructure into your application.
Better Auth Infrastructure: Enterprise-grade dashboard, security, and managed services for Better Auth.
Email Service: Better Auth Infrastructure provides a managed transactional email service with pre-built templates for common authentication flows. Send verification emails, password resets, invitations, and more without managing email infrastructure.
SMS Service: Better Auth Infrastructure provides a managed SMS service for sending OTP codes for phone verification and two-factor authentication. Send verification codes without managing SMS providers.
Audit Logs: Track and query authentication events across your application with automatic audit logging.
Dashboard Plugin (dash): The dash() plugin connects your Better Auth instance to Better Auth Infrastructure, enabling analytics tracking, event logging, and admin dashboard APIs.
Dashboard: The dash() plugin connects your Better Auth instance to Better Auth Infrastructure, enabling analytics tracking, activity monitoring, and admin dashboard APIs.
Security Plugin (sentinel): The sentinel() plugin provides comprehensive security and abuse protection for your authentication system. It detects and prevents various attack vectors including credential stuffing, impossible travel, free trial abuse, and more.

Installation

Installation: Learn how to configure Better Auth in your project.

Integrations

Astro Integration: Integrate Better Auth with Astro.
Convex Integration: Integrate Better Auth with Convex.
Electron Integration: Integrate Better Auth with Electron.
Elysia Integration: Integrate Better Auth with Elysia.
Encore Integration: Integrate Better Auth with Encore.
Expo Integration: Integrate Better Auth with Expo.
Express Integration: Integrate Better Auth with Express.
Better Auth Fastify Integration Guide: Learn how to seamlessly integrate Better Auth with your Fastify application.
Hono Integration: Integrate Better Auth with Hono.
Lynx Integration: Integrate Better Auth with Lynx cross-platform framework.
NestJS Integration: Integrate Better Auth with NestJS.
Next.js integration: Integrate Better Auth with Next.js.
Nitro Integration: Integrate Better Auth with Nitro.
Nuxt Integration: Integrate Better Auth with Nuxt.
React Router v7 Integration: Integrate Better Auth with React Router v7 (formerly Remix).
SolidStart Integration: Integrate Better Auth with SolidStart.
SvelteKit Integration: Integrate Better Auth with SvelteKit.
TanStack Start Integration: Integrate Better Auth with TanStack Start.
Waku Integration: Integrate Better Auth with Waku.

Introduction

Introduction: Introduction to Better Auth.

Plugins

Two-Factor Authentication (2FA): Enhance your app's security with two-factor authentication.
Admin: Admin plugin for Better Auth
Agent Auth: Agent identity, registration, discovery, and capability-based authorization for AI agents.
Anonymous: Anonymous plugin for Better Auth.
Autumn Billing: Better Auth Plugin for Autumn Billing
Bearer Token Authentication: Authenticate API requests using Bearer tokens instead of browser cookies
Captcha: Captcha plugin
Chargebee: Chargebee plugin for Better Auth to manage subscriptions and payments.
Commet: Better Auth Plugin for Billing and Subscriptions using Commet
Community Plugins: Community-built plugins that extend Better Auth.
Creem: Better Auth Plugin for Payment and Subscriptions using Creem
Device Authorization: OAuth 2.0 Device Authorization Grant for limited-input devices
Dodo Payments: Better Auth Plugin for Dodo Payments
Dub: Better Auth Plugin for Lead Tracking using Dub links and OAuth Linking
Email OTP: Email OTP plugin for Better Auth.
Generic OAuth: Authenticate users with any OAuth provider
Have I Been Pwned: A plugin to check if a password has been compromised
i18n: Internationalization plugin for translating error messages
Plugins: Browse all Better Auth plugins — authentication, authorization, payments, security, and more.
JWT: Authenticate users with JWT tokens in services that can't use the session
Last Login Method: Track and display the last authentication method used by users
Magic link: Magic link plugin
MCP: MCP provider plugin for Better Auth
Multi Session: Learn how to use multi-session plugin in Better Auth.
OAuth 2.1 Provider: A Better Auth plugin that enables your auth server to serve as an OAuth 2.1 provider.
OAuth Proxy: OAuth Proxy plugin for Better Auth
OIDC Provider: Open ID Connect plugin for Better Auth that allows you to have your own OIDC provider.
One Tap: One Tap plugin for Better Auth
One-Time Token Plugin: Generate and verify single-use token
Open API: Open API reference for Better Auth.
Organization: The organization plugin allows you to manage your organization's members and teams.
Passkey: Passkey
Phone Number: Phone number plugin
Polar: Better Auth Plugin for Payment and Checkouts using Polar
System for Cross-domain Identity Management (SCIM): Integrate SCIM with your application.
Sign In With Ethereum (SIWE): Sign in with Ethereum plugin for Better Auth
Single Sign-On (SSO): Integrate Single Sign-On (SSO) with your application.
Stripe: Stripe plugin for Better Auth to manage subscriptions and payments.
Test Utils: Testing utilities for integration and E2E testing
Username: Username plugin
Advanced Features: Advanced API Key features including sessions, multiple configurations, organization keys, storage modes, and more.
API Key: API Key plugin for Better Auth.
Reference: API Key plugin options, permissions, and schema reference.

Reference

Contributing to BetterAuth: A concise guide to contributing to BetterAuth
FAQ: Frequently asked questions about Better Auth.
Instrumentation (Experimental): Distributed tracing for Better Auth
Options: Better Auth configuration options reference.
Resources: A curated collection of resources to help you learn and master Better Auth.
Security: Better Auth security features.
Telemetry: Better Auth now collects anonymous telemetry data about general usage.
account_already_linked_to_different_user: The account is already linked to a different user.
account_not_linked: The provider account is not linked to the current user and cannot be linked automatically.
email_doesn't_match: The email doesn't match the email of the account.
email_not_found: The provider did not return an email address.
Errors: Errors that can occur in Better Auth.
internal_server_error: An unexpected error occurred during authentication.
invalid_callback_request: The callback request is invalid.
invalid_code: The provided authentication code is invalid or expired.
no_callback_url: The callback URL was not found in the request.
no_code: The code was not found in the request.
oauth_provider_not_found: The OAuth provider was not found.
signup_disabled: Signup disabled error
state_invalid: Failed to decrypt or parse the OAuth state during the callback.
state_mismatch: State verification failed during the OAuth callback. Covers all state-related error codes and their causes.
state_not_found: The state parameter was not found in the request.
unable_to_create_session: The session could not be created during authentication.
unable_to_create_user: The user could not be created during authentication.
unable_to_get_user_info: The user info was not found in the request.
unable_to_link_account: The account could not be linked.
Unknown error: An unknown error occurred.