Better Auth Documentation

Complete Better Auth documentation embedded in markdown. Read from references/ to answer questions about authentication implementation, OAuth setup, database configuration, and framework integration.

Documentation Structure

All documentation is in references/ organized by topic:

Core Documentation

#### Getting Started

• references/introduction.mdx - What is Better Auth
• references/installation.mdx - Setup guide
• references/basic-usage.mdx - Authentication basics
• references/comparison.mdx - vs other auth libraries

#### Authentication Methods (references/authentication/) OAuth providers and authentication strategies:

• google.mdx - Google OAuth
• github.mdx - GitHub OAuth
• microsoft.mdx - Microsoft/Azure AD
• apple.mdx - Apple Sign In
• discord.mdx, facebook.mdx, twitter.mdx, etc.
• email-password.mdx - Email & password auth
• magic-link.mdx - Passwordless magic links
• passkey.mdx - WebAuthn passkeys

#### Database Adapters (references/adapters/)

• prisma.mdx - Prisma ORM
• drizzle.mdx - Drizzle ORM
• kysely.mdx - Kysely
• mongodb.mdx - MongoDB
• pg.mdx - node-postgres

#### Concepts (references/concepts/) Core authentication concepts:

• session.mdx - Session management
• oauth.mdx - OAuth flow
• database.mdx - Database schema
• rate-limit.mdx - Rate limiting
• middleware.mdx - Auth middleware
• cookies.mdx - Cookie handling

#### Plugins (references/plugins/) Extension features:

• two-factor.mdx - 2FA/TOTP
• passkey.mdx - WebAuthn/passkeys
• email-verification.mdx - Email verification
• magic-link.mdx - Magic link auth
• organization.mdx - Organizations & teams
• multi-session.mdx - Multiple sessions
• anonymous.mdx - Anonymous users

#### Integrations (references/integrations/) Framework-specific guides:

• next-js.mdx - Next.js integration
• sveltekit.mdx - SvelteKit
• astro.mdx - Astro
• solid-start.mdx - SolidStart

#### Examples (references/examples/) Working examples:

• next-js.mdx - Complete Next.js example
• sveltekit.mdx - SvelteKit example

#### Guides (references/guides/) How-to guides:

• custom-session.mdx - Custom session handling
• testing.mdx - Testing auth flows
• deployment.mdx - Production deployment

#### API Reference (references/reference/) Complete API documentation.

Quick Reference

Common Tasks

Task	File to Read
Initial setup	references/installation.mdx
Email & password auth	references/authentication/email-password.mdx
Google OAuth	references/authentication/google.mdx
GitHub OAuth	references/authentication/github.mdx
Setup with Prisma	references/adapters/prisma.mdx
Setup with Drizzle	references/adapters/drizzle.mdx
Session management	references/concepts/session.mdx
Add 2FA	references/plugins/two-factor.mdx
Add passkeys	references/plugins/passkey.mdx
Next.js integration	references/integrations/next-js.mdx
Organizations/teams	references/plugins/organization.mdx
Rate limiting	references/concepts/rate-limit.mdx

When to Use This Skill

• Implementing authentication in a TypeScript project
• Setting up OAuth providers (Google, GitHub, Microsoft, etc.)
• Configuring database adapters (Prisma, Drizzle, etc.)
• Adding 2FA, passkeys, or magic links
• Managing sessions and cookies
• Integrating with Next.js, SvelteKit, or other frameworks
• Questions about auth patterns and best practices

How to Navigate

• Start with references/introduction.mdx for overview
• For setup: Read references/installation.mdx
• For auth methods: Browse references/authentication/
• For database: Check references/adapters/
• For advanced features: See references/plugins/
• For framework integration: Use references/integrations/

All files are .mdx (Markdown + JSX) but readable as plain markdown.