[{"data":1,"prerenderedAt":558},["ShallowReactive",2],{"navigation_docs":3,"-getting-started":152,"-getting-started-surround":555},[4,42,68,110,131],{"title":5,"path":6,"stem":7,"children":8,"icon":11},"Getting Started","/getting-started","1.getting-started/0.index",[9,12,17,22,27,32,37],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-sparkles",{"title":13,"path":14,"stem":15,"icon":16},"Installation","/getting-started/installation","1.getting-started/1.installation","i-lucide-download",{"title":18,"path":19,"stem":20,"icon":21},"Configuration","/getting-started/configuration","1.getting-started/2.configuration","i-lucide-settings",{"title":23,"path":24,"stem":25,"icon":26},"Client Setup","/getting-started/client-setup","1.getting-started/3.client-setup","i-lucide-monitor",{"title":28,"path":29,"stem":30,"icon":31},"Type Augmentation","/getting-started/type-augmentation","1.getting-started/4.type-augmentation","i-lucide-type",{"title":33,"path":34,"stem":35,"icon":36},"Schema Generation (NuxtHub)","/getting-started/schema-generation","1.getting-started/5.schema-generation","i-lucide-database",{"title":38,"path":39,"stem":40,"icon":41},"How It Works","/getting-started/how-it-works","1.getting-started/6.how-it-works","i-lucide-workflow",{"title":43,"path":44,"stem":45,"children":46,"page":67},"Core Concepts","/core-concepts","2.core-concepts",[47,51,55,59,63],{"title":48,"path":49,"stem":50},"serverAuth()","/core-concepts/server-auth","2.core-concepts/1.server-auth",{"title":52,"path":53,"stem":54},"Sessions","/core-concepts/sessions","2.core-concepts/2.sessions",{"title":56,"path":57,"stem":58},"Route Protection","/core-concepts/route-protection","2.core-concepts/3.route-protection",{"title":60,"path":61,"stem":62},"Auto‑Imports and Aliases","/core-concepts/auto-imports-aliases","2.core-concepts/4.auto-imports-aliases",{"title":64,"path":65,"stem":66},"Security & Caveats","/core-concepts/security-caveats","2.core-concepts/5.security-caveats",false,{"title":69,"path":70,"stem":71,"children":72,"page":67},"Guides","/guides","3.guides",[73,77,81,85,89,94,98,102,106],{"title":74,"path":75,"stem":76},"Role‑Based Access","/guides/role-based-access","3.guides/1.role-based-access",{"title":78,"path":79,"stem":80},"OAuth Providers","/guides/oauth-providers","3.guides/2.oauth-providers",{"title":82,"path":83,"stem":84},"Custom Database","/guides/custom-database","3.guides/3.custom-database",{"title":86,"path":87,"stem":88},"Database-less Mode","/guides/database-less-mode","3.guides/4.database-less-mode",{"title":90,"path":91,"stem":92,"icon":93},"External Auth Backend","/guides/external-auth-backend","3.guides/5.external-auth-backend","i-lucide-server",{"title":95,"path":96,"stem":97},"Migrating from nuxt-auth-utils","/guides/migrate-from-nuxt-auth-utils","3.guides/6.migrate-from-nuxt-auth-utils",{"title":99,"path":100,"stem":101},"Two-Factor Authentication (TOTP + Backup Codes)","/guides/two-factor-auth","3.guides/7.two-factor-auth",{"title":103,"path":104,"stem":105},"Testing","/guides/testing","3.guides/8.testing",{"title":107,"path":108,"stem":109},"Production Deployment","/guides/production-deployment","3.guides/9.production-deployment",{"title":111,"path":112,"stem":113,"children":114,"page":67},"Integrations","/integrations","4.integrations",[115,119,123,127],{"title":116,"path":117,"stem":118},"NuxtHub","/integrations/nuxthub","4.integrations/1.nuxthub",{"title":120,"path":121,"stem":122},"DevTools","/integrations/devtools","4.integrations/2.devtools",{"title":124,"path":125,"stem":126},"Convex","/integrations/convex","4.integrations/3.convex",{"title":128,"path":129,"stem":130},"i18n","/integrations/i18n","4.integrations/4.i18n",{"title":132,"path":133,"stem":134,"children":135,"page":67},"API Reference","/api","5.api",[136,140,144,148],{"title":137,"path":138,"stem":139},"Composables","/api/composables","5.api/1.composables",{"title":141,"path":142,"stem":143},"Server Utilities","/api/server-utils","5.api/2.server-utils",{"title":145,"path":146,"stem":147},"Components","/api/components","5.api/3.components",{"title":149,"path":150,"stem":151},"Types","/api/types","5.api/4.types",{"id":153,"title":10,"body":154,"description":548,"extension":549,"links":550,"meta":551,"navigation":552,"path":6,"seo":553,"stem":7,"__hash__":554},"docs/1.getting-started/0.index.md",{"type":155,"value":156,"toc":537},"minimark",[157,170,180,185,188,192,196,199,215,218,222,225,487,502,506,509,533],[158,159,160,161,165,166,169],"p",{},"Nuxt Better Auth integrates ",[162,163,164],"strong",{},"Nuxt"," and ",[162,167,168],{},"Better Auth",", the TypeScript-first authentication library. You get route protection, session management, and schema generation with minimal setup. The plugin ecosystem adds features like 2FA, organizations, and passkeys.",[171,172,176,179],"card",{"icon":173,"target":174,"to":175},"i-lucide-external-link","_blank","https://demo-nuxt-better-auth.onmax.me",[162,177,178],{},"Live Demo"," – Try the authentication flow in action.",[181,182,184],"h2",{"id":183},"features","Features",[158,186,187],{},"This module brings Nuxt-specific enhancements on top of Better Auth:",[189,190],"docs-features",{":features":191},"[{\"title\":\"Auto Configuration\",\"description\":\"Auto-wires API routes, middleware, and schema with sensible defaults\"},{\"title\":\"Route Protection\",\"description\":\"Declarative page and API route guards\"},{\"title\":\"Schema Generation\",\"description\":\"Auto-generate Drizzle schemas\"},{\"title\":\"Reactive Sessions\",\"description\":\"`useUserSession()` with SSR support\"},{\"title\":\"Database Flexibility\",\"description\":\"Works standalone or with NuxtHub\"},{\"title\":\"Type Safety\",\"description\":\"Full TypeScript inference\"},{\"title\":\"Auto Imports\",\"description\":\"Composables and utils ready to use\"},{\"title\":\"Server Utilities\",\"description\":\"Auth helpers for your API routes\"},{\"title\":\"Powered by Better Auth\",\"description\":\"2FA, OAuth, SSO, organizations, and more\",\"href\":\"https://www.better-auth.com\"}]",[181,193,195],{"id":194},"why-nuxt-better-auth","Why Nuxt Better Auth?",[158,197,198],{},"Building authentication from scratch is hard. Wiring up Better Auth with Nuxt manually involves:",[200,201,202,206,209,212],"ul",{},[203,204,205],"li",{},"Setting up API handlers",[203,207,208],{},"Syncing client/server state",[203,210,211],{},"Handling redirects",[203,213,214],{},"Managing database schemas (if using a database)",[158,216,217],{},"This module does all of that for you. Just configure your auth providers and the module handles the rest.",[181,219,221],{"id":220},"quick-start","Quick Start",[158,223,224],{},"Get a working login in 5 minutes with NuxtHub (SQLite).",[226,227,228,233,268,272,330,342,346,414,451,455],"steps",{},[229,230,232],"h3",{"id":231},"install","Install",[234,235,240],"pre",{"className":236,"code":237,"language":238,"meta":239,"style":239},"language-bash shiki shiki-themes one-light synthwave-84 synthwave-84","npx nuxi module add @onmax/nuxt-better-auth@alpha @nuxthub/core\n","bash","",[241,242,243],"code",{"__ignoreMap":239},[244,245,248,252,256,259,262,265],"span",{"class":246,"line":247},"line",1,[244,249,251],{"class":250},"siqUp","npx",[244,253,255],{"class":254},"sI3kV"," nuxi",[244,257,258],{"class":254}," module",[244,260,261],{"class":254}," add",[244,263,264],{"class":254}," @onmax/nuxt-better-auth@alpha",[244,266,267],{"class":254}," @nuxthub/core\n",[229,269,271],{"id":270},"configure","Configure",[234,273,278],{"className":274,"code":275,"filename":276,"language":277,"meta":239,"style":239},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","export default defineNuxtConfig({\n  hub: { db: 'sqlite' },\n})\n","nuxt.config.ts","ts",[241,279,280,298,324],{"__ignoreMap":239},[244,281,282,286,290,294],{"class":246,"line":247},[244,283,285],{"class":284},"sqe1H","export",[244,287,289],{"class":288},"sKg8T"," default",[244,291,293],{"class":292},"sfT9l"," defineNuxtConfig",[244,295,297],{"class":296},"s17Py","({\n",[244,299,301,305,309,312,315,317,321],{"class":246,"line":300},2,[244,302,304],{"class":303},"sYvLG","  hub",[244,306,308],{"class":307},"sVnqq",":",[244,310,311],{"class":296}," { ",[244,313,314],{"class":303},"db",[244,316,308],{"class":307},[244,318,320],{"class":319},"sPAZv"," 'sqlite'",[244,322,323],{"class":296}," },\n",[244,325,327],{"class":246,"line":326},3,[244,328,329],{"class":296},"})\n",[234,331,336],{"className":332,"code":333,"filename":334,"language":335,"meta":239,"style":239},"language-ini shiki shiki-themes one-light synthwave-84 synthwave-84","NUXT_BETTER_AUTH_SECRET=\"generate-a-32-char-secret\"\n",".env","ini",[241,337,338],{"__ignoreMap":239},[244,339,340],{"class":246,"line":247},[244,341,333],{},[229,343,345],{"id":344},"create-config-files","Create Config Files",[234,347,350],{"className":274,"code":348,"filename":349,"language":277,"meta":239,"style":239},"import { defineServerAuth } from '@onmax/nuxt-better-auth/config'\n\nexport default defineServerAuth({\n  emailAndPassword: { enabled: true },\n})\n","server/auth.config.ts",[241,351,352,371,377,388,409],{"__ignoreMap":239},[244,353,354,357,359,362,365,368],{"class":246,"line":247},[244,355,356],{"class":284},"import",[244,358,311],{"class":296},[244,360,361],{"class":303},"defineServerAuth",[244,363,364],{"class":296}," } ",[244,366,367],{"class":284},"from",[244,369,370],{"class":319}," '@onmax/nuxt-better-auth/config'\n",[244,372,373],{"class":246,"line":300},[244,374,376],{"emptyLinePlaceholder":375},true,"\n",[244,378,379,381,383,386],{"class":246,"line":326},[244,380,285],{"class":284},[244,382,289],{"class":288},[244,384,385],{"class":292}," defineServerAuth",[244,387,297],{"class":296},[244,389,391,394,396,398,401,403,407],{"class":246,"line":390},4,[244,392,393],{"class":303},"  emailAndPassword",[244,395,308],{"class":307},[244,397,311],{"class":296},[244,399,400],{"class":303},"enabled",[244,402,308],{"class":307},[244,404,406],{"class":405},"s3ZNE"," true",[244,408,323],{"class":296},[244,410,412],{"class":246,"line":411},5,[244,413,329],{"class":296},[234,415,418],{"className":274,"code":416,"filename":417,"language":277,"meta":239,"style":239},"import { defineClientAuth } from '@onmax/nuxt-better-auth/config'\n\nexport default defineClientAuth({})\n","app/auth.config.ts",[241,419,420,435,439],{"__ignoreMap":239},[244,421,422,424,426,429,431,433],{"class":246,"line":247},[244,423,356],{"class":284},[244,425,311],{"class":296},[244,427,428],{"class":303},"defineClientAuth",[244,430,364],{"class":296},[244,432,367],{"class":284},[244,434,370],{"class":319},[244,436,437],{"class":246,"line":300},[244,438,376],{"emptyLinePlaceholder":375},[244,440,441,443,445,448],{"class":246,"line":326},[244,442,285],{"class":284},[244,444,289],{"class":288},[244,446,447],{"class":292}," defineClientAuth",[244,449,450],{"class":296},"({})\n",[229,452,454],{"id":453},"run","Run",[456,457,459,472],"code-group",{"sync":458},"pm",[234,460,463],{"className":236,"code":461,"filename":462,"language":238,"meta":239,"style":239},"pnpm dev\n","pnpm",[241,464,465],{"__ignoreMap":239},[244,466,467,469],{"class":246,"line":247},[244,468,462],{"class":250},[244,470,471],{"class":254}," dev\n",[234,473,476],{"className":236,"code":474,"filename":475,"language":238,"meta":239,"style":239},"npm run dev\n","npm",[241,477,478],{"__ignoreMap":239},[244,479,480,482,485],{"class":246,"line":247},[244,481,475],{"class":250},[244,483,484],{"class":254}," run",[244,486,471],{"class":254},[158,488,489,490,493,494,497,498,501],{},"You now have API routes at ",[241,491,492],{},"/api/auth/*",", a reactive ",[241,495,496],{},"useUserSession()"," composable, and route protection via ",[241,499,500],{},"definePageMeta",".",[181,503,505],{"id":504},"recommended-path-for-beginners","Recommended Path for Beginners",[158,507,508],{},"If this is your first setup, follow this order:",[510,511,512,517,521,525,529],"ol",{},[203,513,514],{},[515,516,13],"a",{"href":14},[203,518,519],{},[515,520,18],{"href":19},[203,522,523],{},[515,524,23],{"href":24},[203,526,527],{},[515,528,56],{"href":57},[203,530,531],{},[515,532,132],{"href":138},[534,535,536],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .siqUp, html code.shiki .siqUp{--shiki-light:#4078F2;--shiki-default:#FE4450;--shiki-dark:#FE4450}html pre.shiki code .sI3kV, html code.shiki .sI3kV{--shiki-light:#50A14F;--shiki-default:#BBBBBB;--shiki-dark:#BBBBBB}html pre.shiki code .sqe1H, html code.shiki .sqe1H{--shiki-light:#A626A4;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}html pre.shiki code .sKg8T, html code.shiki .sKg8T{--shiki-light:#E45649;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}html pre.shiki code .sfT9l, html code.shiki .sfT9l{--shiki-light:#4078F2;--shiki-default:#36F9F6;--shiki-dark:#36F9F6}html pre.shiki code .s17Py, html code.shiki .s17Py{--shiki-light:#383A42;--shiki-default:#BBBBBB;--shiki-dark:#BBBBBB}html pre.shiki code .sYvLG, html code.shiki .sYvLG{--shiki-light:#E45649;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .sVnqq, html code.shiki .sVnqq{--shiki-light:#0184BC;--shiki-default:#B6B1B1;--shiki-dark:#B6B1B1}html pre.shiki code .sPAZv, html code.shiki .sPAZv{--shiki-light:#50A14F;--shiki-default:#FF8B39;--shiki-dark:#FF8B39}html pre.shiki code .s3ZNE, html code.shiki .s3ZNE{--shiki-light:#986801;--shiki-default:#F97E72;--shiki-dark:#F97E72}",{"title":239,"searchDepth":300,"depth":300,"links":538},[539,540,541,547],{"id":183,"depth":300,"text":184},{"id":194,"depth":300,"text":195},{"id":220,"depth":300,"text":221,"children":542},[543,544,545,546],{"id":231,"depth":326,"text":232},{"id":270,"depth":326,"text":271},{"id":344,"depth":326,"text":345},{"id":453,"depth":326,"text":454},{"id":504,"depth":300,"text":505},"Nuxt Better Auth integrates Better Auth with Nuxt for route protection, session management, and schema generation.","md",null,{},{"icon":11},{"title":10,"description":548},"g7oHXOmQ-N0LbyIP7QE6GVYSNZIBUH8a_4UxErFyYM0",[550,556],{"title":13,"path":14,"stem":15,"description":557,"icon":16,"children":-1},"Learn how to add Nuxt Better Auth to your Nuxt project.",1775080951679]