javimosch 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 Authreferences/installation.mdx- Setup guidereferences/basic-usage.mdx- Authentication basicsreferences/comparison.mdx- vs other auth libraries
Authentication Methods (references/authentication/)
OAuth providers and authentication strategies:
google.mdx- Google OAuthgithub.mdx- GitHub OAuthmicrosoft.mdx- Microsoft/Azure ADapple.mdx- Apple Sign Indiscord.mdx,facebook.mdx,twitter.mdx, etc.email-password.mdx- Email & password authmagic-link.mdx- Passwordless magic linkspasskey.mdx- WebAuthn passkeys
Database Adapters (references/adapters/)
prisma.mdx- Prisma ORMdrizzle.mdx- Drizzle ORMkysely.mdx- Kyselymongodb.mdx- MongoDBpg.mdx- node-postgres
Concepts (references/concepts/)
Core authentication concepts:
session.mdx- Session managementoauth.mdx- OAuth flowdatabase.mdx- Database schemarate-limit.mdx- Rate limitingmiddleware.mdx- Auth middlewarecookies.mdx- Cookie handling
Plugins (references/plugins/)
Extension features:
two-factor.mdx- 2FA/TOTPpasskey.mdx- WebAuthn/passkeysemail-verification.mdx- Email verificationmagic-link.mdx- Magic link authorganization.mdx- Organizations & teamsmulti-session.mdx- Multiple sessionsanonymous.mdx- Anonymous users
Integrations (references/integrations/)
Framework-specific guides:
next-js.mdx- Next.js integrationsveltekit.mdx- SvelteKitastro.mdx- Astrosolid-start.mdx- SolidStart
Examples (references/examples/)
Working examples:
next-js.mdx- Complete Next.js examplesveltekit.mdx- SvelteKit example
Guides (references/guides/)
How-to guides:
custom-session.mdx- Custom session handlingtesting.mdx- Testing auth flowsdeployment.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.mdxfor 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.