# Documentation

## API Schemas

- [OpenAPI schema](/api/docs?format=openapi): Machine-readable API schema for tool use and API clients; rendered API reference at /api-reference

## Pages

- [Introduction](/docs.md): A comprehensive authentication and authorization framework for TypeScript.
- [Authentication](/docs/authentication.md): Authentication methods — email/password, social sign-on, and more.
- [Email Verification](/docs/authentication/email-verification.md): Verify user email addresses with magic tokens and custom email templates.
- [Social Sign-on](/docs/authentication/social-sign-on.md): Set up OAuth social login with Google, GitHub, Discord, and more.
- [Basic Usage](/docs/basic-usage.md): Learn the fundamental auth flows — sign up, sign in, and session management.
- [Concepts](/docs/concepts.md): Core concepts and architecture of Better Auth.
- [Database](/docs/concepts/database.md): Database schema, adapters, and automatic migrations.
- [Session Management](/docs/concepts/session-management.md): How sessions work in Better Auth — creation, validation, refresh, and security.
- [Create Content](/docs/create-content.md): Write and format documentation content.
- [Code Blocks](/docs/create-content/code-blocks.md): Syntax highlighting and code block features.
- [Format Text](/docs/create-content/format-text.md): Text formatting options in MDX documentation.
- [Images & Embeds](/docs/create-content/images-embeds.md): Add images, videos, and embedded content to your docs.
- [Customize](/docs/customize.md): Customize the look and feel of your documentation.
- [Custom 404 Page](/docs/customize/custom-404.md): Customize the 404 error page for your documentation.
- [Custom Domain](/docs/customize/custom-domain.md): Connect your own domain to your documentation site.
- [Custom Scripts](/docs/customize/custom-scripts.md): Add custom scripts and analytics to your docs.
- [Fonts](/docs/customize/fonts.md): Configure custom fonts for your documentation.
- [React](/docs/customize/react-components.md): Add custom React components to your MDX pages.
- [Themes](/docs/customize/themes.md): Choose and configure documentation themes.
- [Get Started](/docs/getting-started.md): Build your first authentication flow with Better Auth.
- [Agent-Ready Docs](/docs/getting-started/agent-ready-docs.md): A single docs page that gives humans the full story and agents a focused sibling markdown guide.
- [AI-Native](/docs/getting-started/ai-native.md): Configure AI-powered search and chat for your documentation.
- [Migration Guide](/docs/getting-started/migration-guide.md): Migrate from other documentation frameworks.
- [Quickstart](/docs/getting-started/quickstart.md): Get your documentation site running in under 5 minutes.
- [Installation](/docs/installation.md): Install and configure Better Auth in your project.
- [Integrations](/docs/integrations.md): Framework integrations — Next.js, Nuxt, SvelteKit, Astro, and more.
- [Organize](/docs/organize.md): Structure and organize your documentation content.
- [Agent Pages](/docs/organize/agent-pages.md): Keep a human page and an optional agent-only companion sidecar in the same folder.
- [Exclude Files](/docs/organize/exclude-files.md): Exclude specific files or directories from documentation.
- [Global Settings](/docs/organize/global-settings.md): Configure global settings for your documentation site.
- [Hidden Pages](/docs/organize/hidden-pages.md): Hide pages from the sidebar while keeping them accessible.
- [Navigation](/docs/organize/navigation.md): Configure navigation and sidebar ordering.
- [Pages](/docs/organize/pages.md): Configure page metadata, titles, and frontmatter properties.
- [Overview](/docs/overview.md): Human-facing overview page for the docs example.
- [Plugins](/docs/plugins.md): Extend Better Auth with powerful plugins — 2FA, organizations, passkeys, and more.
- [Organizations](/docs/plugins/organizations.md): Multi-tenant organization management with roles and invitations.
- [Two Factor Authentication](/docs/plugins/two-factor.md): Add TOTP-based two factor authentication with backup codes.
- [Quickstart](/docs/quickstart.md): Get up and running in minutes
- [API Reference: OpenAPI mode is now the default](/docs/changelogs/2026-04-15.md): The Next example now ships with the faster OpenAPI experience, plus a tighter docs/API switcher.
- [Colorful theme cleanup across docs and API routes](/docs/changelogs/2026-04-03.md): We tightened the theme handoff so the colorful preset keeps its own identity when moving between docs and API reference.
- [Cloud page motion pass](/docs/changelogs/2026-03-18.md): The cloud landing page picked up smoother looping motion, better path-based SVG behavior, and more stable theme controls.