[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-better-auth-better-auth-best-practices":3,"mdc--coqjvj-key":33,"related-repo-better-auth-better-auth-best-practices":1997,"related-org-better-auth-better-auth-best-practices":2073},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":31,"mdContent":32},"better-auth-best-practices","configure Better Auth servers and clients","Configure Better Auth server and client, set up database adapters, manage sessions, add plugins, and handle environment variables. Use when users mention Better Auth, betterauth, auth.ts, or need to set up TypeScript authentication with email\u002Fpassword, OAuth, or plugin configuration.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"better-auth","Better Auth","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fbetter-auth.png",[12,14,17,20],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Sessions","sessions",{"name":18,"slug":19,"type":13},"Auth","auth",{"name":21,"slug":22,"type":13},"TypeScript","typescript",201,"https:\u002F\u002Fgithub.com\u002Fbetter-auth\u002Fskills","2026-04-06T18:05:01.910941",null,28,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":26},[],"https:\u002F\u002Fgithub.com\u002Fbetter-auth\u002Fskills\u002Ftree\u002FHEAD\u002Fbetter-auth\u002Fbest-practices","---\nname: better-auth-best-practices\ndescription: Configure Better Auth server and client, set up database adapters, manage sessions, add plugins, and handle environment variables. Use when users mention Better Auth, betterauth, auth.ts, or need to set up TypeScript authentication with email\u002Fpassword, OAuth, or plugin configuration.\n---\n\n# Better Auth Integration Guide\n\n**Always consult [better-auth.com\u002Fdocs](https:\u002F\u002Fbetter-auth.com\u002Fdocs) for code examples and latest API.**\n\n---\n\n## Setup Workflow\n\n1. Install: `npm install better-auth`\n2. Set env vars: `BETTER_AUTH_SECRET` and `BETTER_AUTH_URL`\n3. Create `auth.ts` with database + config\n4. Create route handler for your framework\n5. Run migrations:\n   - **Built-in adapter:** `npx @better-auth\u002Fcli@latest migrate`\n   - **Drizzle:** `npx @better-auth\u002Fcli@latest generate --output src\u002Fdb\u002Fauth-schema.ts` then `npx drizzle-kit push` (dev) or `npx drizzle-kit generate && npx drizzle-kit migrate` (prod)\n   - **Prisma:** `npx @better-auth\u002Fcli@latest generate --output prisma\u002Fschema.prisma` then `npx prisma migrate dev`\n6. Verify: call `GET \u002Fapi\u002Fauth\u002Fok` — should return `{ status: \"ok\" }`\n\n---\n\n## Quick Reference\n\n### Environment Variables\n- `BETTER_AUTH_SECRET` - Encryption secret (min 32 chars). Generate: `openssl rand -base64 32`\n- `BETTER_AUTH_URL` - Base URL (e.g., `https:\u002F\u002Fexample.com`)\n\nOnly define `baseURL`\u002F`secret` in config if env vars are NOT set.\n\n### File Location\nCLI looks for `auth.ts` in: `.\u002F`, `.\u002Flib`, `.\u002Futils`, or under `.\u002Fsrc`. Use `--config` for custom path.\n\n### CLI Commands\n- `npx @better-auth\u002Fcli@latest migrate` - Apply schema (built-in adapter)\n- `npx @better-auth\u002Fcli@latest generate` - Generate schema for Prisma\u002FDrizzle\n- `npx @better-auth\u002Fcli mcp --cursor` - Add MCP to AI tools\n\n**Re-run after adding\u002Fchanging plugins.**\n\n---\n\n## Core Config Options\n\n| Option | Notes |\n|--------|-------|\n| `appName` | Optional display name |\n| `baseURL` | Only if `BETTER_AUTH_URL` not set |\n| `basePath` | Default `\u002Fapi\u002Fauth`. Set `\u002F` for root. |\n| `secret` | Only if `BETTER_AUTH_SECRET` not set |\n| `database` | Required for most features. See adapters docs. |\n| `secondaryStorage` | Redis\u002FKV for sessions & rate limits |\n| `emailAndPassword` | `{ enabled: true }` to activate |\n| `socialProviders` | `{ google: { clientId, clientSecret }, ... }` |\n| `plugins` | Array of plugins |\n| `trustedOrigins` | CSRF whitelist |\n\n---\n\n## Database\n\n**Direct connections:** Pass `pg.Pool`, `mysql2` pool, `better-sqlite3`, or `bun:sqlite` instance. For Postgres, also supports `postgres` (postgres.js) and `@neondatabase\u002Fserverless`.\n\n**ORM adapters:** Import from `better-auth\u002Fadapters\u002Fdrizzle`, `better-auth\u002Fadapters\u002Fprisma`, `better-auth\u002Fadapters\u002Fmongodb`.\n\n**Drizzle provider values:** `\"pg\"` (PostgreSQL), `\"mysql\"` (MySQL), `\"sqlite\"` (SQLite). Must match the driver used.\n\n**Critical:** Better Auth uses adapter model names, NOT underlying table names. If Prisma model is `User` mapping to table `users`, use `modelName: \"user\"` (Prisma reference), not `\"users\"`.\n\n---\n\n## Session Management\n\n**Storage priority:**\n1. If `secondaryStorage` defined → sessions go there (not DB)\n2. Set `session.storeSessionInDatabase: true` to also persist to DB\n3. No database + `cookieCache` → fully stateless mode\n\n**Cookie cache strategies:**\n- `compact` (default) - Base64url + HMAC. Smallest.\n- `jwt` - Standard JWT. Readable but signed.\n- `jwe` - Encrypted. Maximum security.\n\n**Key options:** `session.expiresIn` (default 7 days), `session.updateAge` (refresh interval), `session.cookieCache.maxAge`, `session.cookieCache.version` (change to invalidate all sessions).\n\n---\n\n## User & Account Config\n\n**User:** `user.modelName`, `user.fields` (column mapping), `user.additionalFields`, `user.changeEmail.enabled` (disabled by default), `user.deleteUser.enabled` (disabled by default).\n\n**Account:** `account.modelName`, `account.accountLinking.enabled`, `account.storeAccountCookie` (for stateless OAuth).\n\n**Required for registration:** `email` and `name` fields.\n\n---\n\n## Email Flows\n\n- `emailVerification.sendVerificationEmail` - Must be defined for verification to work\n- `emailVerification.sendOnSignUp` \u002F `sendOnSignIn` - Auto-send triggers\n- `emailAndPassword.sendResetPassword` - Password reset email handler\n\n---\n\n## Security\n\n**In `advanced`:**\n- `useSecureCookies` - Force HTTPS cookies\n- `disableCSRFCheck` - ⚠️ Security risk\n- `disableOriginCheck` - ⚠️ Security risk  \n- `crossSubDomainCookies.enabled` - Share cookies across subdomains\n- `ipAddress.ipAddressHeaders` - Custom IP headers for proxies\n- `database.generateId` - Custom ID generation or `\"serial\"`\u002F`\"uuid\"`\u002F`false`\n\n**Rate limiting:** `rateLimit.enabled`, `rateLimit.window`, `rateLimit.max`, `rateLimit.storage` (\"memory\" | \"database\" | \"secondary-storage\").\n\n---\n\n## Hooks\n\n**Endpoint hooks:** `hooks.before` \u002F `hooks.after` - Array of `{ matcher, handler }`. Use `createAuthMiddleware`. Access `ctx.path`, `ctx.context.returned` (after), `ctx.context.session`.\n\n**Database hooks:** `databaseHooks.user.create.before\u002Fafter`, same for `session`, `account`. Useful for adding default values or post-creation actions.\n\n**Hook context (`ctx.context`):** `session`, `secret`, `authCookies`, `password.hash()`\u002F`verify()`, `adapter`, `internalAdapter`, `generateId()`, `tables`, `baseURL`.\n\n---\n\n## Plugins\n\n**Import from dedicated paths for tree-shaking:**\n```\nimport { twoFactor } from \"better-auth\u002Fplugins\u002Ftwo-factor\"\n```\nNOT `from \"better-auth\u002Fplugins\"`.\n\n**Popular plugins:** `twoFactor`, `organization`, `passkey`, `magicLink`, `emailOtp`, `username`, `phoneNumber`, `admin`, `apiKey`, `bearer`, `jwt`, `multiSession`, `sso`, `oauthProvider`, `oidcProvider`, `openAPI`, `genericOAuth`.\n\nClient plugins go in `createAuthClient({ plugins: [...] })`.\n\n---\n\n## Client\n\nImport from: `better-auth\u002Fclient` (vanilla), `better-auth\u002Freact`, `better-auth\u002Fvue`, `better-auth\u002Fsvelte`, `better-auth\u002Fsolid`.\n\nKey methods: `signUp.email()`, `signIn.email()`, `signIn.social()`, `signOut()`, `useSession()`, `getSession()`, `revokeSession()`, `revokeSessions()`.\n\n---\n\n## Type Safety\n\nInfer types: `typeof auth.$Infer.Session`, `typeof auth.$Infer.Session.user`.\n\nFor separate client\u002Fserver projects: `createAuthClient\u003Ctypeof auth>()`.\n\n---\n\n## Common Gotchas\n\n1. **Model vs table name** - Config uses ORM model name, not DB table name\n2. **Plugin schema** - Re-run CLI after adding plugins\n3. **Secondary storage** - Sessions go there by default, not DB\n4. **Cookie cache** - Custom session fields NOT cached, always re-fetched\n5. **Stateless mode** - No DB = session in cookie only, logout on cache expiry\n6. **Change email flow** - Sends to current email first, then new email\n7. **Drizzle: db not initialized** - `drizzleAdapter(db, ...)` requires a `db` instance from `drizzle()`. See `create-auth` skill for setup examples (node-postgres, postgres.js, Neon).\n8. **Drizzle: missing drizzle.config.ts** - `drizzle-kit` commands require a `drizzle.config.ts` pointing to the generated schema file and DB credentials.\n\n---\n\n## Resources\n\n- [Docs](https:\u002F\u002Fbetter-auth.com\u002Fdocs)\n- [Options Reference](https:\u002F\u002Fbetter-auth.com\u002Fdocs\u002Freference\u002Foptions)\n- [LLMs.txt](https:\u002F\u002Fbetter-auth.com\u002Fllms.txt)\n- [GitHub](https:\u002F\u002Fgithub.com\u002Fbetter-auth\u002Fbetter-auth)\n- [Init Options Source](https:\u002F\u002Fgithub.com\u002Fbetter-auth\u002Fbetter-auth\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fsrc\u002Ftypes\u002Finit-options.ts)",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,47,68,72,79,232,235,241,248,285,306,312,363,369,404,412,415,421,654,657,662,719,750,783,824,827,833,841,882,890,926,966,969,975,1022,1053,1077,1080,1086,1130,1133,1139,1155,1243,1281,1284,1290,1351,1383,1467,1470,1475,1483,1495,1507,1634,1646,1649,1655,1696,1757,1760,1766,1785,1797,1800,1806,1936,1939,1945],{"type":39,"tag":40,"props":41,"children":43},"element","h1",{"id":42},"better-auth-integration-guide",[44],{"type":45,"value":46},"text","Better Auth Integration Guide",{"type":39,"tag":48,"props":49,"children":50},"p",{},[51],{"type":39,"tag":52,"props":53,"children":54},"strong",{},[55,57,66],{"type":45,"value":56},"Always consult ",{"type":39,"tag":58,"props":59,"children":63},"a",{"href":60,"rel":61},"https:\u002F\u002Fbetter-auth.com\u002Fdocs",[62],"nofollow",[64],{"type":45,"value":65},"better-auth.com\u002Fdocs",{"type":45,"value":67}," for code examples and latest API.",{"type":39,"tag":69,"props":70,"children":71},"hr",{},[],{"type":39,"tag":73,"props":74,"children":76},"h2",{"id":75},"setup-workflow",[77],{"type":45,"value":78},"Setup Workflow",{"type":39,"tag":80,"props":81,"children":82},"ol",{},[83,96,115,128,133,213],{"type":39,"tag":84,"props":85,"children":86},"li",{},[87,89],{"type":45,"value":88},"Install: ",{"type":39,"tag":90,"props":91,"children":93},"code",{"className":92},[],[94],{"type":45,"value":95},"npm install better-auth",{"type":39,"tag":84,"props":97,"children":98},{},[99,101,107,109],{"type":45,"value":100},"Set env vars: ",{"type":39,"tag":90,"props":102,"children":104},{"className":103},[],[105],{"type":45,"value":106},"BETTER_AUTH_SECRET",{"type":45,"value":108}," and ",{"type":39,"tag":90,"props":110,"children":112},{"className":111},[],[113],{"type":45,"value":114},"BETTER_AUTH_URL",{"type":39,"tag":84,"props":116,"children":117},{},[118,120,126],{"type":45,"value":119},"Create ",{"type":39,"tag":90,"props":121,"children":123},{"className":122},[],[124],{"type":45,"value":125},"auth.ts",{"type":45,"value":127}," with database + config",{"type":39,"tag":84,"props":129,"children":130},{},[131],{"type":45,"value":132},"Create route handler for your framework",{"type":39,"tag":84,"props":134,"children":135},{},[136,138],{"type":45,"value":137},"Run migrations:\n",{"type":39,"tag":139,"props":140,"children":141},"ul",{},[142,158,191],{"type":39,"tag":84,"props":143,"children":144},{},[145,150,152],{"type":39,"tag":52,"props":146,"children":147},{},[148],{"type":45,"value":149},"Built-in adapter:",{"type":45,"value":151}," ",{"type":39,"tag":90,"props":153,"children":155},{"className":154},[],[156],{"type":45,"value":157},"npx @better-auth\u002Fcli@latest migrate",{"type":39,"tag":84,"props":159,"children":160},{},[161,166,167,173,175,181,183,189],{"type":39,"tag":52,"props":162,"children":163},{},[164],{"type":45,"value":165},"Drizzle:",{"type":45,"value":151},{"type":39,"tag":90,"props":168,"children":170},{"className":169},[],[171],{"type":45,"value":172},"npx @better-auth\u002Fcli@latest generate --output src\u002Fdb\u002Fauth-schema.ts",{"type":45,"value":174}," then ",{"type":39,"tag":90,"props":176,"children":178},{"className":177},[],[179],{"type":45,"value":180},"npx drizzle-kit push",{"type":45,"value":182}," (dev) or ",{"type":39,"tag":90,"props":184,"children":186},{"className":185},[],[187],{"type":45,"value":188},"npx drizzle-kit generate && npx drizzle-kit migrate",{"type":45,"value":190}," (prod)",{"type":39,"tag":84,"props":192,"children":193},{},[194,199,200,206,207],{"type":39,"tag":52,"props":195,"children":196},{},[197],{"type":45,"value":198},"Prisma:",{"type":45,"value":151},{"type":39,"tag":90,"props":201,"children":203},{"className":202},[],[204],{"type":45,"value":205},"npx @better-auth\u002Fcli@latest generate --output prisma\u002Fschema.prisma",{"type":45,"value":174},{"type":39,"tag":90,"props":208,"children":210},{"className":209},[],[211],{"type":45,"value":212},"npx prisma migrate dev",{"type":39,"tag":84,"props":214,"children":215},{},[216,218,224,226],{"type":45,"value":217},"Verify: call ",{"type":39,"tag":90,"props":219,"children":221},{"className":220},[],[222],{"type":45,"value":223},"GET \u002Fapi\u002Fauth\u002Fok",{"type":45,"value":225}," — should return ",{"type":39,"tag":90,"props":227,"children":229},{"className":228},[],[230],{"type":45,"value":231},"{ status: \"ok\" }",{"type":39,"tag":69,"props":233,"children":234},{},[],{"type":39,"tag":73,"props":236,"children":238},{"id":237},"quick-reference",[239],{"type":45,"value":240},"Quick Reference",{"type":39,"tag":242,"props":243,"children":245},"h3",{"id":244},"environment-variables",[246],{"type":45,"value":247},"Environment Variables",{"type":39,"tag":139,"props":249,"children":250},{},[251,267],{"type":39,"tag":84,"props":252,"children":253},{},[254,259,261],{"type":39,"tag":90,"props":255,"children":257},{"className":256},[],[258],{"type":45,"value":106},{"type":45,"value":260}," - Encryption secret (min 32 chars). Generate: ",{"type":39,"tag":90,"props":262,"children":264},{"className":263},[],[265],{"type":45,"value":266},"openssl rand -base64 32",{"type":39,"tag":84,"props":268,"children":269},{},[270,275,277,283],{"type":39,"tag":90,"props":271,"children":273},{"className":272},[],[274],{"type":45,"value":114},{"type":45,"value":276}," - Base URL (e.g., ",{"type":39,"tag":90,"props":278,"children":280},{"className":279},[],[281],{"type":45,"value":282},"https:\u002F\u002Fexample.com",{"type":45,"value":284},")",{"type":39,"tag":48,"props":286,"children":287},{},[288,290,296,298,304],{"type":45,"value":289},"Only define ",{"type":39,"tag":90,"props":291,"children":293},{"className":292},[],[294],{"type":45,"value":295},"baseURL",{"type":45,"value":297},"\u002F",{"type":39,"tag":90,"props":299,"children":301},{"className":300},[],[302],{"type":45,"value":303},"secret",{"type":45,"value":305}," in config if env vars are NOT set.",{"type":39,"tag":242,"props":307,"children":309},{"id":308},"file-location",[310],{"type":45,"value":311},"File Location",{"type":39,"tag":48,"props":313,"children":314},{},[315,317,322,324,330,332,338,339,345,347,353,355,361],{"type":45,"value":316},"CLI looks for ",{"type":39,"tag":90,"props":318,"children":320},{"className":319},[],[321],{"type":45,"value":125},{"type":45,"value":323}," in: ",{"type":39,"tag":90,"props":325,"children":327},{"className":326},[],[328],{"type":45,"value":329},".\u002F",{"type":45,"value":331},", ",{"type":39,"tag":90,"props":333,"children":335},{"className":334},[],[336],{"type":45,"value":337},".\u002Flib",{"type":45,"value":331},{"type":39,"tag":90,"props":340,"children":342},{"className":341},[],[343],{"type":45,"value":344},".\u002Futils",{"type":45,"value":346},", or under ",{"type":39,"tag":90,"props":348,"children":350},{"className":349},[],[351],{"type":45,"value":352},".\u002Fsrc",{"type":45,"value":354},". Use ",{"type":39,"tag":90,"props":356,"children":358},{"className":357},[],[359],{"type":45,"value":360},"--config",{"type":45,"value":362}," for custom path.",{"type":39,"tag":242,"props":364,"children":366},{"id":365},"cli-commands",[367],{"type":45,"value":368},"CLI Commands",{"type":39,"tag":139,"props":370,"children":371},{},[372,382,393],{"type":39,"tag":84,"props":373,"children":374},{},[375,380],{"type":39,"tag":90,"props":376,"children":378},{"className":377},[],[379],{"type":45,"value":157},{"type":45,"value":381}," - Apply schema (built-in adapter)",{"type":39,"tag":84,"props":383,"children":384},{},[385,391],{"type":39,"tag":90,"props":386,"children":388},{"className":387},[],[389],{"type":45,"value":390},"npx @better-auth\u002Fcli@latest generate",{"type":45,"value":392}," - Generate schema for Prisma\u002FDrizzle",{"type":39,"tag":84,"props":394,"children":395},{},[396,402],{"type":39,"tag":90,"props":397,"children":399},{"className":398},[],[400],{"type":45,"value":401},"npx @better-auth\u002Fcli mcp --cursor",{"type":45,"value":403}," - Add MCP to AI tools",{"type":39,"tag":48,"props":405,"children":406},{},[407],{"type":39,"tag":52,"props":408,"children":409},{},[410],{"type":45,"value":411},"Re-run after adding\u002Fchanging plugins.",{"type":39,"tag":69,"props":413,"children":414},{},[],{"type":39,"tag":73,"props":416,"children":418},{"id":417},"core-config-options",[419],{"type":45,"value":420},"Core Config Options",{"type":39,"tag":422,"props":423,"children":424},"table",{},[425,444],{"type":39,"tag":426,"props":427,"children":428},"thead",{},[429],{"type":39,"tag":430,"props":431,"children":432},"tr",{},[433,439],{"type":39,"tag":434,"props":435,"children":436},"th",{},[437],{"type":45,"value":438},"Option",{"type":39,"tag":434,"props":440,"children":441},{},[442],{"type":45,"value":443},"Notes",{"type":39,"tag":445,"props":446,"children":447},"tbody",{},[448,466,489,521,542,559,576,599,620,637],{"type":39,"tag":430,"props":449,"children":450},{},[451,461],{"type":39,"tag":452,"props":453,"children":454},"td",{},[455],{"type":39,"tag":90,"props":456,"children":458},{"className":457},[],[459],{"type":45,"value":460},"appName",{"type":39,"tag":452,"props":462,"children":463},{},[464],{"type":45,"value":465},"Optional display name",{"type":39,"tag":430,"props":467,"children":468},{},[469,477],{"type":39,"tag":452,"props":470,"children":471},{},[472],{"type":39,"tag":90,"props":473,"children":475},{"className":474},[],[476],{"type":45,"value":295},{"type":39,"tag":452,"props":478,"children":479},{},[480,482,487],{"type":45,"value":481},"Only if ",{"type":39,"tag":90,"props":483,"children":485},{"className":484},[],[486],{"type":45,"value":114},{"type":45,"value":488}," not set",{"type":39,"tag":430,"props":490,"children":491},{},[492,501],{"type":39,"tag":452,"props":493,"children":494},{},[495],{"type":39,"tag":90,"props":496,"children":498},{"className":497},[],[499],{"type":45,"value":500},"basePath",{"type":39,"tag":452,"props":502,"children":503},{},[504,506,512,514,519],{"type":45,"value":505},"Default ",{"type":39,"tag":90,"props":507,"children":509},{"className":508},[],[510],{"type":45,"value":511},"\u002Fapi\u002Fauth",{"type":45,"value":513},". Set ",{"type":39,"tag":90,"props":515,"children":517},{"className":516},[],[518],{"type":45,"value":297},{"type":45,"value":520}," for root.",{"type":39,"tag":430,"props":522,"children":523},{},[524,532],{"type":39,"tag":452,"props":525,"children":526},{},[527],{"type":39,"tag":90,"props":528,"children":530},{"className":529},[],[531],{"type":45,"value":303},{"type":39,"tag":452,"props":533,"children":534},{},[535,536,541],{"type":45,"value":481},{"type":39,"tag":90,"props":537,"children":539},{"className":538},[],[540],{"type":45,"value":106},{"type":45,"value":488},{"type":39,"tag":430,"props":543,"children":544},{},[545,554],{"type":39,"tag":452,"props":546,"children":547},{},[548],{"type":39,"tag":90,"props":549,"children":551},{"className":550},[],[552],{"type":45,"value":553},"database",{"type":39,"tag":452,"props":555,"children":556},{},[557],{"type":45,"value":558},"Required for most features. See adapters docs.",{"type":39,"tag":430,"props":560,"children":561},{},[562,571],{"type":39,"tag":452,"props":563,"children":564},{},[565],{"type":39,"tag":90,"props":566,"children":568},{"className":567},[],[569],{"type":45,"value":570},"secondaryStorage",{"type":39,"tag":452,"props":572,"children":573},{},[574],{"type":45,"value":575},"Redis\u002FKV for sessions & rate limits",{"type":39,"tag":430,"props":577,"children":578},{},[579,588],{"type":39,"tag":452,"props":580,"children":581},{},[582],{"type":39,"tag":90,"props":583,"children":585},{"className":584},[],[586],{"type":45,"value":587},"emailAndPassword",{"type":39,"tag":452,"props":589,"children":590},{},[591,597],{"type":39,"tag":90,"props":592,"children":594},{"className":593},[],[595],{"type":45,"value":596},"{ enabled: true }",{"type":45,"value":598}," to activate",{"type":39,"tag":430,"props":600,"children":601},{},[602,611],{"type":39,"tag":452,"props":603,"children":604},{},[605],{"type":39,"tag":90,"props":606,"children":608},{"className":607},[],[609],{"type":45,"value":610},"socialProviders",{"type":39,"tag":452,"props":612,"children":613},{},[614],{"type":39,"tag":90,"props":615,"children":617},{"className":616},[],[618],{"type":45,"value":619},"{ google: { clientId, clientSecret }, ... }",{"type":39,"tag":430,"props":621,"children":622},{},[623,632],{"type":39,"tag":452,"props":624,"children":625},{},[626],{"type":39,"tag":90,"props":627,"children":629},{"className":628},[],[630],{"type":45,"value":631},"plugins",{"type":39,"tag":452,"props":633,"children":634},{},[635],{"type":45,"value":636},"Array of plugins",{"type":39,"tag":430,"props":638,"children":639},{},[640,649],{"type":39,"tag":452,"props":641,"children":642},{},[643],{"type":39,"tag":90,"props":644,"children":646},{"className":645},[],[647],{"type":45,"value":648},"trustedOrigins",{"type":39,"tag":452,"props":650,"children":651},{},[652],{"type":45,"value":653},"CSRF whitelist",{"type":39,"tag":69,"props":655,"children":656},{},[],{"type":39,"tag":73,"props":658,"children":659},{"id":553},[660],{"type":45,"value":661},"Database",{"type":39,"tag":48,"props":663,"children":664},{},[665,670,672,678,679,685,687,693,695,701,703,709,711,717],{"type":39,"tag":52,"props":666,"children":667},{},[668],{"type":45,"value":669},"Direct connections:",{"type":45,"value":671}," Pass ",{"type":39,"tag":90,"props":673,"children":675},{"className":674},[],[676],{"type":45,"value":677},"pg.Pool",{"type":45,"value":331},{"type":39,"tag":90,"props":680,"children":682},{"className":681},[],[683],{"type":45,"value":684},"mysql2",{"type":45,"value":686}," pool, ",{"type":39,"tag":90,"props":688,"children":690},{"className":689},[],[691],{"type":45,"value":692},"better-sqlite3",{"type":45,"value":694},", or ",{"type":39,"tag":90,"props":696,"children":698},{"className":697},[],[699],{"type":45,"value":700},"bun:sqlite",{"type":45,"value":702}," instance. For Postgres, also supports ",{"type":39,"tag":90,"props":704,"children":706},{"className":705},[],[707],{"type":45,"value":708},"postgres",{"type":45,"value":710}," (postgres.js) and ",{"type":39,"tag":90,"props":712,"children":714},{"className":713},[],[715],{"type":45,"value":716},"@neondatabase\u002Fserverless",{"type":45,"value":718},".",{"type":39,"tag":48,"props":720,"children":721},{},[722,727,729,735,736,742,743,749],{"type":39,"tag":52,"props":723,"children":724},{},[725],{"type":45,"value":726},"ORM adapters:",{"type":45,"value":728}," Import from ",{"type":39,"tag":90,"props":730,"children":732},{"className":731},[],[733],{"type":45,"value":734},"better-auth\u002Fadapters\u002Fdrizzle",{"type":45,"value":331},{"type":39,"tag":90,"props":737,"children":739},{"className":738},[],[740],{"type":45,"value":741},"better-auth\u002Fadapters\u002Fprisma",{"type":45,"value":331},{"type":39,"tag":90,"props":744,"children":746},{"className":745},[],[747],{"type":45,"value":748},"better-auth\u002Fadapters\u002Fmongodb",{"type":45,"value":718},{"type":39,"tag":48,"props":751,"children":752},{},[753,758,759,765,767,773,775,781],{"type":39,"tag":52,"props":754,"children":755},{},[756],{"type":45,"value":757},"Drizzle provider values:",{"type":45,"value":151},{"type":39,"tag":90,"props":760,"children":762},{"className":761},[],[763],{"type":45,"value":764},"\"pg\"",{"type":45,"value":766}," (PostgreSQL), ",{"type":39,"tag":90,"props":768,"children":770},{"className":769},[],[771],{"type":45,"value":772},"\"mysql\"",{"type":45,"value":774}," (MySQL), ",{"type":39,"tag":90,"props":776,"children":778},{"className":777},[],[779],{"type":45,"value":780},"\"sqlite\"",{"type":45,"value":782}," (SQLite). Must match the driver used.",{"type":39,"tag":48,"props":784,"children":785},{},[786,791,793,799,801,807,809,815,817,823],{"type":39,"tag":52,"props":787,"children":788},{},[789],{"type":45,"value":790},"Critical:",{"type":45,"value":792}," Better Auth uses adapter model names, NOT underlying table names. If Prisma model is ",{"type":39,"tag":90,"props":794,"children":796},{"className":795},[],[797],{"type":45,"value":798},"User",{"type":45,"value":800}," mapping to table ",{"type":39,"tag":90,"props":802,"children":804},{"className":803},[],[805],{"type":45,"value":806},"users",{"type":45,"value":808},", use ",{"type":39,"tag":90,"props":810,"children":812},{"className":811},[],[813],{"type":45,"value":814},"modelName: \"user\"",{"type":45,"value":816}," (Prisma reference), not ",{"type":39,"tag":90,"props":818,"children":820},{"className":819},[],[821],{"type":45,"value":822},"\"users\"",{"type":45,"value":718},{"type":39,"tag":69,"props":825,"children":826},{},[],{"type":39,"tag":73,"props":828,"children":830},{"id":829},"session-management",[831],{"type":45,"value":832},"Session Management",{"type":39,"tag":48,"props":834,"children":835},{},[836],{"type":39,"tag":52,"props":837,"children":838},{},[839],{"type":45,"value":840},"Storage priority:",{"type":39,"tag":80,"props":842,"children":843},{},[844,856,869],{"type":39,"tag":84,"props":845,"children":846},{},[847,849,854],{"type":45,"value":848},"If ",{"type":39,"tag":90,"props":850,"children":852},{"className":851},[],[853],{"type":45,"value":570},{"type":45,"value":855}," defined → sessions go there (not DB)",{"type":39,"tag":84,"props":857,"children":858},{},[859,861,867],{"type":45,"value":860},"Set ",{"type":39,"tag":90,"props":862,"children":864},{"className":863},[],[865],{"type":45,"value":866},"session.storeSessionInDatabase: true",{"type":45,"value":868}," to also persist to DB",{"type":39,"tag":84,"props":870,"children":871},{},[872,874,880],{"type":45,"value":873},"No database + ",{"type":39,"tag":90,"props":875,"children":877},{"className":876},[],[878],{"type":45,"value":879},"cookieCache",{"type":45,"value":881}," → fully stateless mode",{"type":39,"tag":48,"props":883,"children":884},{},[885],{"type":39,"tag":52,"props":886,"children":887},{},[888],{"type":45,"value":889},"Cookie cache strategies:",{"type":39,"tag":139,"props":891,"children":892},{},[893,904,915],{"type":39,"tag":84,"props":894,"children":895},{},[896,902],{"type":39,"tag":90,"props":897,"children":899},{"className":898},[],[900],{"type":45,"value":901},"compact",{"type":45,"value":903}," (default) - Base64url + HMAC. Smallest.",{"type":39,"tag":84,"props":905,"children":906},{},[907,913],{"type":39,"tag":90,"props":908,"children":910},{"className":909},[],[911],{"type":45,"value":912},"jwt",{"type":45,"value":914}," - Standard JWT. Readable but signed.",{"type":39,"tag":84,"props":916,"children":917},{},[918,924],{"type":39,"tag":90,"props":919,"children":921},{"className":920},[],[922],{"type":45,"value":923},"jwe",{"type":45,"value":925}," - Encrypted. Maximum security.",{"type":39,"tag":48,"props":927,"children":928},{},[929,934,935,941,943,949,951,957,958,964],{"type":39,"tag":52,"props":930,"children":931},{},[932],{"type":45,"value":933},"Key options:",{"type":45,"value":151},{"type":39,"tag":90,"props":936,"children":938},{"className":937},[],[939],{"type":45,"value":940},"session.expiresIn",{"type":45,"value":942}," (default 7 days), ",{"type":39,"tag":90,"props":944,"children":946},{"className":945},[],[947],{"type":45,"value":948},"session.updateAge",{"type":45,"value":950}," (refresh interval), ",{"type":39,"tag":90,"props":952,"children":954},{"className":953},[],[955],{"type":45,"value":956},"session.cookieCache.maxAge",{"type":45,"value":331},{"type":39,"tag":90,"props":959,"children":961},{"className":960},[],[962],{"type":45,"value":963},"session.cookieCache.version",{"type":45,"value":965}," (change to invalidate all sessions).",{"type":39,"tag":69,"props":967,"children":968},{},[],{"type":39,"tag":73,"props":970,"children":972},{"id":971},"user-account-config",[973],{"type":45,"value":974},"User & Account Config",{"type":39,"tag":48,"props":976,"children":977},{},[978,983,984,990,991,997,999,1005,1006,1012,1014,1020],{"type":39,"tag":52,"props":979,"children":980},{},[981],{"type":45,"value":982},"User:",{"type":45,"value":151},{"type":39,"tag":90,"props":985,"children":987},{"className":986},[],[988],{"type":45,"value":989},"user.modelName",{"type":45,"value":331},{"type":39,"tag":90,"props":992,"children":994},{"className":993},[],[995],{"type":45,"value":996},"user.fields",{"type":45,"value":998}," (column mapping), ",{"type":39,"tag":90,"props":1000,"children":1002},{"className":1001},[],[1003],{"type":45,"value":1004},"user.additionalFields",{"type":45,"value":331},{"type":39,"tag":90,"props":1007,"children":1009},{"className":1008},[],[1010],{"type":45,"value":1011},"user.changeEmail.enabled",{"type":45,"value":1013}," (disabled by default), ",{"type":39,"tag":90,"props":1015,"children":1017},{"className":1016},[],[1018],{"type":45,"value":1019},"user.deleteUser.enabled",{"type":45,"value":1021}," (disabled by default).",{"type":39,"tag":48,"props":1023,"children":1024},{},[1025,1030,1031,1037,1038,1044,1045,1051],{"type":39,"tag":52,"props":1026,"children":1027},{},[1028],{"type":45,"value":1029},"Account:",{"type":45,"value":151},{"type":39,"tag":90,"props":1032,"children":1034},{"className":1033},[],[1035],{"type":45,"value":1036},"account.modelName",{"type":45,"value":331},{"type":39,"tag":90,"props":1039,"children":1041},{"className":1040},[],[1042],{"type":45,"value":1043},"account.accountLinking.enabled",{"type":45,"value":331},{"type":39,"tag":90,"props":1046,"children":1048},{"className":1047},[],[1049],{"type":45,"value":1050},"account.storeAccountCookie",{"type":45,"value":1052}," (for stateless OAuth).",{"type":39,"tag":48,"props":1054,"children":1055},{},[1056,1061,1062,1068,1069,1075],{"type":39,"tag":52,"props":1057,"children":1058},{},[1059],{"type":45,"value":1060},"Required for registration:",{"type":45,"value":151},{"type":39,"tag":90,"props":1063,"children":1065},{"className":1064},[],[1066],{"type":45,"value":1067},"email",{"type":45,"value":108},{"type":39,"tag":90,"props":1070,"children":1072},{"className":1071},[],[1073],{"type":45,"value":1074},"name",{"type":45,"value":1076}," fields.",{"type":39,"tag":69,"props":1078,"children":1079},{},[],{"type":39,"tag":73,"props":1081,"children":1083},{"id":1082},"email-flows",[1084],{"type":45,"value":1085},"Email Flows",{"type":39,"tag":139,"props":1087,"children":1088},{},[1089,1100,1119],{"type":39,"tag":84,"props":1090,"children":1091},{},[1092,1098],{"type":39,"tag":90,"props":1093,"children":1095},{"className":1094},[],[1096],{"type":45,"value":1097},"emailVerification.sendVerificationEmail",{"type":45,"value":1099}," - Must be defined for verification to work",{"type":39,"tag":84,"props":1101,"children":1102},{},[1103,1109,1111,1117],{"type":39,"tag":90,"props":1104,"children":1106},{"className":1105},[],[1107],{"type":45,"value":1108},"emailVerification.sendOnSignUp",{"type":45,"value":1110}," \u002F ",{"type":39,"tag":90,"props":1112,"children":1114},{"className":1113},[],[1115],{"type":45,"value":1116},"sendOnSignIn",{"type":45,"value":1118}," - Auto-send triggers",{"type":39,"tag":84,"props":1120,"children":1121},{},[1122,1128],{"type":39,"tag":90,"props":1123,"children":1125},{"className":1124},[],[1126],{"type":45,"value":1127},"emailAndPassword.sendResetPassword",{"type":45,"value":1129}," - Password reset email handler",{"type":39,"tag":69,"props":1131,"children":1132},{},[],{"type":39,"tag":73,"props":1134,"children":1136},{"id":1135},"security",[1137],{"type":45,"value":1138},"Security",{"type":39,"tag":48,"props":1140,"children":1141},{},[1142],{"type":39,"tag":52,"props":1143,"children":1144},{},[1145,1147,1153],{"type":45,"value":1146},"In ",{"type":39,"tag":90,"props":1148,"children":1150},{"className":1149},[],[1151],{"type":45,"value":1152},"advanced",{"type":45,"value":1154},":",{"type":39,"tag":139,"props":1156,"children":1157},{},[1158,1169,1180,1190,1201,1212],{"type":39,"tag":84,"props":1159,"children":1160},{},[1161,1167],{"type":39,"tag":90,"props":1162,"children":1164},{"className":1163},[],[1165],{"type":45,"value":1166},"useSecureCookies",{"type":45,"value":1168}," - Force HTTPS cookies",{"type":39,"tag":84,"props":1170,"children":1171},{},[1172,1178],{"type":39,"tag":90,"props":1173,"children":1175},{"className":1174},[],[1176],{"type":45,"value":1177},"disableCSRFCheck",{"type":45,"value":1179}," - ⚠️ Security risk",{"type":39,"tag":84,"props":1181,"children":1182},{},[1183,1189],{"type":39,"tag":90,"props":1184,"children":1186},{"className":1185},[],[1187],{"type":45,"value":1188},"disableOriginCheck",{"type":45,"value":1179},{"type":39,"tag":84,"props":1191,"children":1192},{},[1193,1199],{"type":39,"tag":90,"props":1194,"children":1196},{"className":1195},[],[1197],{"type":45,"value":1198},"crossSubDomainCookies.enabled",{"type":45,"value":1200}," - Share cookies across subdomains",{"type":39,"tag":84,"props":1202,"children":1203},{},[1204,1210],{"type":39,"tag":90,"props":1205,"children":1207},{"className":1206},[],[1208],{"type":45,"value":1209},"ipAddress.ipAddressHeaders",{"type":45,"value":1211}," - Custom IP headers for proxies",{"type":39,"tag":84,"props":1213,"children":1214},{},[1215,1221,1223,1229,1230,1236,1237],{"type":39,"tag":90,"props":1216,"children":1218},{"className":1217},[],[1219],{"type":45,"value":1220},"database.generateId",{"type":45,"value":1222}," - Custom ID generation or ",{"type":39,"tag":90,"props":1224,"children":1226},{"className":1225},[],[1227],{"type":45,"value":1228},"\"serial\"",{"type":45,"value":297},{"type":39,"tag":90,"props":1231,"children":1233},{"className":1232},[],[1234],{"type":45,"value":1235},"\"uuid\"",{"type":45,"value":297},{"type":39,"tag":90,"props":1238,"children":1240},{"className":1239},[],[1241],{"type":45,"value":1242},"false",{"type":39,"tag":48,"props":1244,"children":1245},{},[1246,1251,1252,1258,1259,1265,1266,1272,1273,1279],{"type":39,"tag":52,"props":1247,"children":1248},{},[1249],{"type":45,"value":1250},"Rate limiting:",{"type":45,"value":151},{"type":39,"tag":90,"props":1253,"children":1255},{"className":1254},[],[1256],{"type":45,"value":1257},"rateLimit.enabled",{"type":45,"value":331},{"type":39,"tag":90,"props":1260,"children":1262},{"className":1261},[],[1263],{"type":45,"value":1264},"rateLimit.window",{"type":45,"value":331},{"type":39,"tag":90,"props":1267,"children":1269},{"className":1268},[],[1270],{"type":45,"value":1271},"rateLimit.max",{"type":45,"value":331},{"type":39,"tag":90,"props":1274,"children":1276},{"className":1275},[],[1277],{"type":45,"value":1278},"rateLimit.storage",{"type":45,"value":1280}," (\"memory\" | \"database\" | \"secondary-storage\").",{"type":39,"tag":69,"props":1282,"children":1283},{},[],{"type":39,"tag":73,"props":1285,"children":1287},{"id":1286},"hooks",[1288],{"type":45,"value":1289},"Hooks",{"type":39,"tag":48,"props":1291,"children":1292},{},[1293,1298,1299,1305,1306,1312,1314,1320,1321,1327,1329,1335,1336,1342,1344,1350],{"type":39,"tag":52,"props":1294,"children":1295},{},[1296],{"type":45,"value":1297},"Endpoint hooks:",{"type":45,"value":151},{"type":39,"tag":90,"props":1300,"children":1302},{"className":1301},[],[1303],{"type":45,"value":1304},"hooks.before",{"type":45,"value":1110},{"type":39,"tag":90,"props":1307,"children":1309},{"className":1308},[],[1310],{"type":45,"value":1311},"hooks.after",{"type":45,"value":1313}," - Array of ",{"type":39,"tag":90,"props":1315,"children":1317},{"className":1316},[],[1318],{"type":45,"value":1319},"{ matcher, handler }",{"type":45,"value":354},{"type":39,"tag":90,"props":1322,"children":1324},{"className":1323},[],[1325],{"type":45,"value":1326},"createAuthMiddleware",{"type":45,"value":1328},". Access ",{"type":39,"tag":90,"props":1330,"children":1332},{"className":1331},[],[1333],{"type":45,"value":1334},"ctx.path",{"type":45,"value":331},{"type":39,"tag":90,"props":1337,"children":1339},{"className":1338},[],[1340],{"type":45,"value":1341},"ctx.context.returned",{"type":45,"value":1343}," (after), ",{"type":39,"tag":90,"props":1345,"children":1347},{"className":1346},[],[1348],{"type":45,"value":1349},"ctx.context.session",{"type":45,"value":718},{"type":39,"tag":48,"props":1352,"children":1353},{},[1354,1359,1360,1366,1368,1374,1375,1381],{"type":39,"tag":52,"props":1355,"children":1356},{},[1357],{"type":45,"value":1358},"Database hooks:",{"type":45,"value":151},{"type":39,"tag":90,"props":1361,"children":1363},{"className":1362},[],[1364],{"type":45,"value":1365},"databaseHooks.user.create.before\u002Fafter",{"type":45,"value":1367},", same for ",{"type":39,"tag":90,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":45,"value":1373},"session",{"type":45,"value":331},{"type":39,"tag":90,"props":1376,"children":1378},{"className":1377},[],[1379],{"type":45,"value":1380},"account",{"type":45,"value":1382},". Useful for adding default values or post-creation actions.",{"type":39,"tag":48,"props":1384,"children":1385},{},[1386,1399,1400,1405,1406,1411,1412,1418,1419,1425,1426,1432,1433,1439,1440,1446,1447,1453,1454,1460,1461,1466],{"type":39,"tag":52,"props":1387,"children":1388},{},[1389,1391,1397],{"type":45,"value":1390},"Hook context (",{"type":39,"tag":90,"props":1392,"children":1394},{"className":1393},[],[1395],{"type":45,"value":1396},"ctx.context",{"type":45,"value":1398},"):",{"type":45,"value":151},{"type":39,"tag":90,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":45,"value":1373},{"type":45,"value":331},{"type":39,"tag":90,"props":1407,"children":1409},{"className":1408},[],[1410],{"type":45,"value":303},{"type":45,"value":331},{"type":39,"tag":90,"props":1413,"children":1415},{"className":1414},[],[1416],{"type":45,"value":1417},"authCookies",{"type":45,"value":331},{"type":39,"tag":90,"props":1420,"children":1422},{"className":1421},[],[1423],{"type":45,"value":1424},"password.hash()",{"type":45,"value":297},{"type":39,"tag":90,"props":1427,"children":1429},{"className":1428},[],[1430],{"type":45,"value":1431},"verify()",{"type":45,"value":331},{"type":39,"tag":90,"props":1434,"children":1436},{"className":1435},[],[1437],{"type":45,"value":1438},"adapter",{"type":45,"value":331},{"type":39,"tag":90,"props":1441,"children":1443},{"className":1442},[],[1444],{"type":45,"value":1445},"internalAdapter",{"type":45,"value":331},{"type":39,"tag":90,"props":1448,"children":1450},{"className":1449},[],[1451],{"type":45,"value":1452},"generateId()",{"type":45,"value":331},{"type":39,"tag":90,"props":1455,"children":1457},{"className":1456},[],[1458],{"type":45,"value":1459},"tables",{"type":45,"value":331},{"type":39,"tag":90,"props":1462,"children":1464},{"className":1463},[],[1465],{"type":45,"value":295},{"type":45,"value":718},{"type":39,"tag":69,"props":1468,"children":1469},{},[],{"type":39,"tag":73,"props":1471,"children":1472},{"id":631},[1473],{"type":45,"value":1474},"Plugins",{"type":39,"tag":48,"props":1476,"children":1477},{},[1478],{"type":39,"tag":52,"props":1479,"children":1480},{},[1481],{"type":45,"value":1482},"Import from dedicated paths for tree-shaking:",{"type":39,"tag":1484,"props":1485,"children":1489},"pre",{"className":1486,"code":1488,"language":45},[1487],"language-text","import { twoFactor } from \"better-auth\u002Fplugins\u002Ftwo-factor\"\n",[1490],{"type":39,"tag":90,"props":1491,"children":1493},{"__ignoreMap":1492},"",[1494],{"type":45,"value":1488},{"type":39,"tag":48,"props":1496,"children":1497},{},[1498,1500,1506],{"type":45,"value":1499},"NOT ",{"type":39,"tag":90,"props":1501,"children":1503},{"className":1502},[],[1504],{"type":45,"value":1505},"from \"better-auth\u002Fplugins\"",{"type":45,"value":718},{"type":39,"tag":48,"props":1508,"children":1509},{},[1510,1515,1516,1522,1523,1529,1530,1536,1537,1543,1544,1550,1551,1557,1558,1564,1565,1571,1572,1578,1579,1585,1586,1591,1592,1598,1599,1605,1606,1612,1613,1619,1620,1626,1627,1633],{"type":39,"tag":52,"props":1511,"children":1512},{},[1513],{"type":45,"value":1514},"Popular plugins:",{"type":45,"value":151},{"type":39,"tag":90,"props":1517,"children":1519},{"className":1518},[],[1520],{"type":45,"value":1521},"twoFactor",{"type":45,"value":331},{"type":39,"tag":90,"props":1524,"children":1526},{"className":1525},[],[1527],{"type":45,"value":1528},"organization",{"type":45,"value":331},{"type":39,"tag":90,"props":1531,"children":1533},{"className":1532},[],[1534],{"type":45,"value":1535},"passkey",{"type":45,"value":331},{"type":39,"tag":90,"props":1538,"children":1540},{"className":1539},[],[1541],{"type":45,"value":1542},"magicLink",{"type":45,"value":331},{"type":39,"tag":90,"props":1545,"children":1547},{"className":1546},[],[1548],{"type":45,"value":1549},"emailOtp",{"type":45,"value":331},{"type":39,"tag":90,"props":1552,"children":1554},{"className":1553},[],[1555],{"type":45,"value":1556},"username",{"type":45,"value":331},{"type":39,"tag":90,"props":1559,"children":1561},{"className":1560},[],[1562],{"type":45,"value":1563},"phoneNumber",{"type":45,"value":331},{"type":39,"tag":90,"props":1566,"children":1568},{"className":1567},[],[1569],{"type":45,"value":1570},"admin",{"type":45,"value":331},{"type":39,"tag":90,"props":1573,"children":1575},{"className":1574},[],[1576],{"type":45,"value":1577},"apiKey",{"type":45,"value":331},{"type":39,"tag":90,"props":1580,"children":1582},{"className":1581},[],[1583],{"type":45,"value":1584},"bearer",{"type":45,"value":331},{"type":39,"tag":90,"props":1587,"children":1589},{"className":1588},[],[1590],{"type":45,"value":912},{"type":45,"value":331},{"type":39,"tag":90,"props":1593,"children":1595},{"className":1594},[],[1596],{"type":45,"value":1597},"multiSession",{"type":45,"value":331},{"type":39,"tag":90,"props":1600,"children":1602},{"className":1601},[],[1603],{"type":45,"value":1604},"sso",{"type":45,"value":331},{"type":39,"tag":90,"props":1607,"children":1609},{"className":1608},[],[1610],{"type":45,"value":1611},"oauthProvider",{"type":45,"value":331},{"type":39,"tag":90,"props":1614,"children":1616},{"className":1615},[],[1617],{"type":45,"value":1618},"oidcProvider",{"type":45,"value":331},{"type":39,"tag":90,"props":1621,"children":1623},{"className":1622},[],[1624],{"type":45,"value":1625},"openAPI",{"type":45,"value":331},{"type":39,"tag":90,"props":1628,"children":1630},{"className":1629},[],[1631],{"type":45,"value":1632},"genericOAuth",{"type":45,"value":718},{"type":39,"tag":48,"props":1635,"children":1636},{},[1637,1639,1645],{"type":45,"value":1638},"Client plugins go in ",{"type":39,"tag":90,"props":1640,"children":1642},{"className":1641},[],[1643],{"type":45,"value":1644},"createAuthClient({ plugins: [...] })",{"type":45,"value":718},{"type":39,"tag":69,"props":1647,"children":1648},{},[],{"type":39,"tag":73,"props":1650,"children":1652},{"id":1651},"client",[1653],{"type":45,"value":1654},"Client",{"type":39,"tag":48,"props":1656,"children":1657},{},[1658,1660,1666,1668,1674,1675,1681,1682,1688,1689,1695],{"type":45,"value":1659},"Import from: ",{"type":39,"tag":90,"props":1661,"children":1663},{"className":1662},[],[1664],{"type":45,"value":1665},"better-auth\u002Fclient",{"type":45,"value":1667}," (vanilla), ",{"type":39,"tag":90,"props":1669,"children":1671},{"className":1670},[],[1672],{"type":45,"value":1673},"better-auth\u002Freact",{"type":45,"value":331},{"type":39,"tag":90,"props":1676,"children":1678},{"className":1677},[],[1679],{"type":45,"value":1680},"better-auth\u002Fvue",{"type":45,"value":331},{"type":39,"tag":90,"props":1683,"children":1685},{"className":1684},[],[1686],{"type":45,"value":1687},"better-auth\u002Fsvelte",{"type":45,"value":331},{"type":39,"tag":90,"props":1690,"children":1692},{"className":1691},[],[1693],{"type":45,"value":1694},"better-auth\u002Fsolid",{"type":45,"value":718},{"type":39,"tag":48,"props":1697,"children":1698},{},[1699,1701,1707,1708,1714,1715,1721,1722,1728,1729,1735,1736,1742,1743,1749,1750,1756],{"type":45,"value":1700},"Key methods: ",{"type":39,"tag":90,"props":1702,"children":1704},{"className":1703},[],[1705],{"type":45,"value":1706},"signUp.email()",{"type":45,"value":331},{"type":39,"tag":90,"props":1709,"children":1711},{"className":1710},[],[1712],{"type":45,"value":1713},"signIn.email()",{"type":45,"value":331},{"type":39,"tag":90,"props":1716,"children":1718},{"className":1717},[],[1719],{"type":45,"value":1720},"signIn.social()",{"type":45,"value":331},{"type":39,"tag":90,"props":1723,"children":1725},{"className":1724},[],[1726],{"type":45,"value":1727},"signOut()",{"type":45,"value":331},{"type":39,"tag":90,"props":1730,"children":1732},{"className":1731},[],[1733],{"type":45,"value":1734},"useSession()",{"type":45,"value":331},{"type":39,"tag":90,"props":1737,"children":1739},{"className":1738},[],[1740],{"type":45,"value":1741},"getSession()",{"type":45,"value":331},{"type":39,"tag":90,"props":1744,"children":1746},{"className":1745},[],[1747],{"type":45,"value":1748},"revokeSession()",{"type":45,"value":331},{"type":39,"tag":90,"props":1751,"children":1753},{"className":1752},[],[1754],{"type":45,"value":1755},"revokeSessions()",{"type":45,"value":718},{"type":39,"tag":69,"props":1758,"children":1759},{},[],{"type":39,"tag":73,"props":1761,"children":1763},{"id":1762},"type-safety",[1764],{"type":45,"value":1765},"Type Safety",{"type":39,"tag":48,"props":1767,"children":1768},{},[1769,1771,1777,1778,1784],{"type":45,"value":1770},"Infer types: ",{"type":39,"tag":90,"props":1772,"children":1774},{"className":1773},[],[1775],{"type":45,"value":1776},"typeof auth.$Infer.Session",{"type":45,"value":331},{"type":39,"tag":90,"props":1779,"children":1781},{"className":1780},[],[1782],{"type":45,"value":1783},"typeof auth.$Infer.Session.user",{"type":45,"value":718},{"type":39,"tag":48,"props":1786,"children":1787},{},[1788,1790,1796],{"type":45,"value":1789},"For separate client\u002Fserver projects: ",{"type":39,"tag":90,"props":1791,"children":1793},{"className":1792},[],[1794],{"type":45,"value":1795},"createAuthClient\u003Ctypeof auth>()",{"type":45,"value":718},{"type":39,"tag":69,"props":1798,"children":1799},{},[],{"type":39,"tag":73,"props":1801,"children":1803},{"id":1802},"common-gotchas",[1804],{"type":45,"value":1805},"Common Gotchas",{"type":39,"tag":80,"props":1807,"children":1808},{},[1809,1819,1829,1839,1849,1859,1869,1911],{"type":39,"tag":84,"props":1810,"children":1811},{},[1812,1817],{"type":39,"tag":52,"props":1813,"children":1814},{},[1815],{"type":45,"value":1816},"Model vs table name",{"type":45,"value":1818}," - Config uses ORM model name, not DB table name",{"type":39,"tag":84,"props":1820,"children":1821},{},[1822,1827],{"type":39,"tag":52,"props":1823,"children":1824},{},[1825],{"type":45,"value":1826},"Plugin schema",{"type":45,"value":1828}," - Re-run CLI after adding plugins",{"type":39,"tag":84,"props":1830,"children":1831},{},[1832,1837],{"type":39,"tag":52,"props":1833,"children":1834},{},[1835],{"type":45,"value":1836},"Secondary storage",{"type":45,"value":1838}," - Sessions go there by default, not DB",{"type":39,"tag":84,"props":1840,"children":1841},{},[1842,1847],{"type":39,"tag":52,"props":1843,"children":1844},{},[1845],{"type":45,"value":1846},"Cookie cache",{"type":45,"value":1848}," - Custom session fields NOT cached, always re-fetched",{"type":39,"tag":84,"props":1850,"children":1851},{},[1852,1857],{"type":39,"tag":52,"props":1853,"children":1854},{},[1855],{"type":45,"value":1856},"Stateless mode",{"type":45,"value":1858}," - No DB = session in cookie only, logout on cache expiry",{"type":39,"tag":84,"props":1860,"children":1861},{},[1862,1867],{"type":39,"tag":52,"props":1863,"children":1864},{},[1865],{"type":45,"value":1866},"Change email flow",{"type":45,"value":1868}," - Sends to current email first, then new email",{"type":39,"tag":84,"props":1870,"children":1871},{},[1872,1877,1879,1885,1887,1893,1895,1901,1903,1909],{"type":39,"tag":52,"props":1873,"children":1874},{},[1875],{"type":45,"value":1876},"Drizzle: db not initialized",{"type":45,"value":1878}," - ",{"type":39,"tag":90,"props":1880,"children":1882},{"className":1881},[],[1883],{"type":45,"value":1884},"drizzleAdapter(db, ...)",{"type":45,"value":1886}," requires a ",{"type":39,"tag":90,"props":1888,"children":1890},{"className":1889},[],[1891],{"type":45,"value":1892},"db",{"type":45,"value":1894}," instance from ",{"type":39,"tag":90,"props":1896,"children":1898},{"className":1897},[],[1899],{"type":45,"value":1900},"drizzle()",{"type":45,"value":1902},". See ",{"type":39,"tag":90,"props":1904,"children":1906},{"className":1905},[],[1907],{"type":45,"value":1908},"create-auth",{"type":45,"value":1910}," skill for setup examples (node-postgres, postgres.js, Neon).",{"type":39,"tag":84,"props":1912,"children":1913},{},[1914,1919,1920,1926,1928,1934],{"type":39,"tag":52,"props":1915,"children":1916},{},[1917],{"type":45,"value":1918},"Drizzle: missing drizzle.config.ts",{"type":45,"value":1878},{"type":39,"tag":90,"props":1921,"children":1923},{"className":1922},[],[1924],{"type":45,"value":1925},"drizzle-kit",{"type":45,"value":1927}," commands require a ",{"type":39,"tag":90,"props":1929,"children":1931},{"className":1930},[],[1932],{"type":45,"value":1933},"drizzle.config.ts",{"type":45,"value":1935}," pointing to the generated schema file and DB credentials.",{"type":39,"tag":69,"props":1937,"children":1938},{},[],{"type":39,"tag":73,"props":1940,"children":1942},{"id":1941},"resources",[1943],{"type":45,"value":1944},"Resources",{"type":39,"tag":139,"props":1946,"children":1947},{},[1948,1957,1967,1977,1987],{"type":39,"tag":84,"props":1949,"children":1950},{},[1951],{"type":39,"tag":58,"props":1952,"children":1954},{"href":60,"rel":1953},[62],[1955],{"type":45,"value":1956},"Docs",{"type":39,"tag":84,"props":1958,"children":1959},{},[1960],{"type":39,"tag":58,"props":1961,"children":1964},{"href":1962,"rel":1963},"https:\u002F\u002Fbetter-auth.com\u002Fdocs\u002Freference\u002Foptions",[62],[1965],{"type":45,"value":1966},"Options Reference",{"type":39,"tag":84,"props":1968,"children":1969},{},[1970],{"type":39,"tag":58,"props":1971,"children":1974},{"href":1972,"rel":1973},"https:\u002F\u002Fbetter-auth.com\u002Fllms.txt",[62],[1975],{"type":45,"value":1976},"LLMs.txt",{"type":39,"tag":84,"props":1978,"children":1979},{},[1980],{"type":39,"tag":58,"props":1981,"children":1984},{"href":1982,"rel":1983},"https:\u002F\u002Fgithub.com\u002Fbetter-auth\u002Fbetter-auth",[62],[1985],{"type":45,"value":1986},"GitHub",{"type":39,"tag":84,"props":1988,"children":1989},{},[1990],{"type":39,"tag":58,"props":1991,"children":1994},{"href":1992,"rel":1993},"https:\u002F\u002Fgithub.com\u002Fbetter-auth\u002Fbetter-auth\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fsrc\u002Ftypes\u002Finit-options.ts",[62],[1995],{"type":45,"value":1996},"Init Options Source",{"items":1998,"total":2072},[1999,2006,2019,2031,2042,2057],{"slug":4,"name":4,"fn":5,"description":6,"org":2000,"tags":2001,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2002,2003,2004,2005],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":15,"slug":16,"type":13},{"name":21,"slug":22,"type":13},{"slug":2007,"name":2007,"fn":2008,"description":2009,"org":2010,"tags":2011,"stars":23,"repoUrl":24,"updatedAt":2018},"better-auth-security-best-practices","configure security best practices for Better Auth","Configure rate limiting, manage auth secrets, set up CSRF protection, define trusted origins, secure sessions and cookies, encrypt OAuth tokens, track IP addresses, and implement audit logging for Better Auth. Use when users need to secure their auth setup, prevent brute force attacks, or harden a Better Auth deployment.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2012,2015,2016,2017],{"name":2013,"slug":2014,"type":13},"Audit","audit",{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":1138,"slug":1135,"type":13},"2026-07-11T05:40:04.318478",{"slug":1908,"name":1908,"fn":2020,"description":2021,"org":2022,"tags":2023,"stars":23,"repoUrl":24,"updatedAt":2030},"scaffold Better Auth in TypeScript apps","Scaffold and implement authentication in TypeScript\u002FJavaScript apps using Better Auth. Detect frameworks, configure database adapters, set up route handlers, add OAuth providers, and create auth UI pages. Use when users want to add login, sign-up, or authentication to a new or existing project with Better Auth.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2024,2025,2026,2029],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2027,"slug":2028,"type":13},"OAuth","oauth",{"name":21,"slug":22,"type":13},"2026-04-06T18:04:59.364175",{"slug":2032,"name":2032,"fn":2033,"description":2034,"org":2035,"tags":2036,"stars":23,"repoUrl":24,"updatedAt":2041},"email-and-password-best-practices","configure Better Auth email and password flows","Configure email verification, implement password reset flows, set password policies, and customise hashing algorithms for Better Auth email\u002Fpassword authentication. Use when users need to set up login, sign-in, sign-up, credential authentication, or password security with Better Auth.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2037,2038,2039],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2040,"slug":1067,"type":13},"Email","2026-04-06T18:05:03.185369",{"slug":2043,"name":2043,"fn":2044,"description":2045,"org":2046,"tags":2047,"stars":23,"repoUrl":24,"updatedAt":2056},"organization-best-practices","set up multi-tenant orgs in Better Auth","Configure multi-tenant organizations, manage members and invitations, define custom roles and permissions, set up teams, and implement RBAC using Better Auth's organization plugin. Use when users need org setup, team management, member roles, access control, or the Better Auth organization plugin.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2048,2049,2050,2053],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2051,"slug":2052,"type":13},"Multi-Tenant","multi-tenant",{"name":2054,"slug":2055,"type":13},"RBAC","rbac","2026-04-06T18:05:00.636075",{"slug":2058,"name":2058,"fn":2059,"description":2060,"org":2061,"tags":2062,"stars":23,"repoUrl":24,"updatedAt":2071},"two-factor-authentication-best-practices","set up 2FA flows in Better Auth","Configure TOTP authenticator apps, send OTP codes via email\u002FSMS, manage backup codes, handle trusted devices, and implement 2FA sign-in flows using Better Auth's twoFactor plugin. Use when users need MFA, multi-factor authentication, authenticator setup, or login security with Better Auth.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2063,2066,2067,2068],{"name":2064,"slug":2065,"type":13},"2FA","two-factor-auth",{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2069,"slug":2070,"type":13},"MFA","mfa","2026-04-06T18:04:58.118682",6,{"items":2074,"total":2072},[2075,2082,2089,2096,2102,2109],{"slug":4,"name":4,"fn":5,"description":6,"org":2076,"tags":2077,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2078,2079,2080,2081],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":15,"slug":16,"type":13},{"name":21,"slug":22,"type":13},{"slug":2007,"name":2007,"fn":2008,"description":2009,"org":2083,"tags":2084,"stars":23,"repoUrl":24,"updatedAt":2018},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2085,2086,2087,2088],{"name":2013,"slug":2014,"type":13},{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":1138,"slug":1135,"type":13},{"slug":1908,"name":1908,"fn":2020,"description":2021,"org":2090,"tags":2091,"stars":23,"repoUrl":24,"updatedAt":2030},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2092,2093,2094,2095],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2027,"slug":2028,"type":13},{"name":21,"slug":22,"type":13},{"slug":2032,"name":2032,"fn":2033,"description":2034,"org":2097,"tags":2098,"stars":23,"repoUrl":24,"updatedAt":2041},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2099,2100,2101],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2040,"slug":1067,"type":13},{"slug":2043,"name":2043,"fn":2044,"description":2045,"org":2103,"tags":2104,"stars":23,"repoUrl":24,"updatedAt":2056},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2105,2106,2107,2108],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2051,"slug":2052,"type":13},{"name":2054,"slug":2055,"type":13},{"slug":2058,"name":2058,"fn":2059,"description":2060,"org":2110,"tags":2111,"stars":23,"repoUrl":24,"updatedAt":2071},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2112,2113,2114,2115],{"name":2064,"slug":2065,"type":13},{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":2069,"slug":2070,"type":13}]