[{"data":1,"prerenderedAt":587},["ShallowReactive",2],{"navigation_docs":3,"-getting-started":152,"-getting-started-surround":584},[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":577,"extension":578,"links":579,"meta":580,"navigation":581,"path":6,"seo":582,"stem":7,"__hash__":583},"docs/1.getting-started/0.index.md",{"type":155,"value":156,"toc":564},"minimark",[157,161,164,181,196,201,204,234,238,259,263,490,494,497,515,525,529,560],[158,159,160],"p",{},"Use this page when you want the fastest path to a working Nuxt 4 setup.",[158,162,163],{},"This quickstart assumes:",[165,166,167,171,178],"ul",{},[168,169,170],"li",{},"you want the default full-mode setup",[168,172,173,174],{},"you are using ",[175,176,177],"code",{},"pnpm",[168,179,180],{},"you want a local login flow working before you customize providers or plugins",[158,182,183,184,187,188,191,192,195],{},"If you already know you need a different architecture, jump to ",[185,186,116],"a",{"href":117},", ",[185,189,190],{"href":83},"custom database",", or ",[185,193,194],{"href":91},"external auth backend",".",[197,198,200],"h2",{"id":199},"what-you-will-end-up-with","What you will end up with",[158,202,203],{},"After this guide you should have:",[165,205,206,215,221,227],{},[168,207,208,211,212],{},[175,209,210],{},"server/auth.config.ts"," and ",[175,213,214],{},"app/auth.config.ts",[168,216,217,218],{},"Better Auth handlers mounted at ",[175,219,220],{},"/api/auth/*",[168,222,223,224],{},"a valid ",[175,225,226],{},"NUXT_BETTER_AUTH_SECRET",[168,228,229,230,233],{},"a reactive ",[175,231,232],{},"useUserSession()"," composable in your app",[197,235,237],{"id":236},"before-you-begin","Before you begin",[165,239,240,246,253],{},[168,241,242,243],{},"Nuxt ",[175,244,245],{},"4.x",[168,247,248,249,252],{},"a local ",[175,250,251],{},".env"," file",[168,254,255,256],{},"a development server you can start with ",[175,257,258],{},"pnpm dev",[197,260,262],{"id":261},"quickstart","Quickstart",[264,265,266,271,302,306,312,323,333,337,433,437,474,478],"steps",{},[267,268,270],"h3",{"id":269},"install-the-module","Install the module",[272,273,278],"pre",{"className":274,"code":275,"language":276,"meta":277,"style":277},"language-bash shiki shiki-themes one-light synthwave-84 synthwave-84","npx nuxi module add @onmax/nuxt-better-auth@alpha\n","bash","",[175,279,280],{"__ignoreMap":277},[281,282,285,289,293,296,299],"span",{"class":283,"line":284},"line",1,[281,286,288],{"class":287},"siqUp","npx",[281,290,292],{"class":291},"sI3kV"," nuxi",[281,294,295],{"class":291}," module",[281,297,298],{"class":291}," add",[281,300,301],{"class":291}," @onmax/nuxt-better-auth@alpha\n",[267,303,305],{"id":304},"add-your-secret","Add your secret",[158,307,308,309,311],{},"Create or update ",[175,310,251],{},":",[272,313,317],{"className":314,"code":315,"filename":251,"language":316,"meta":277,"style":277},"language-ini shiki shiki-themes one-light synthwave-84 synthwave-84","NUXT_BETTER_AUTH_SECRET=\"replace-with-a-random-32-character-secret\"\n","ini",[175,318,319],{"__ignoreMap":277},[281,320,321],{"class":283,"line":284},[281,322,315],{},[158,324,325,326,329,330,332],{},"Use a high-entropy value. The module also accepts ",[175,327,328],{},"BETTER_AUTH_SECRET"," as a fallback, but ",[175,331,226],{}," is the recommended variable.",[267,334,336],{"id":335},"create-the-server-config","Create the server config",[272,338,342],{"className":339,"code":340,"filename":210,"language":341,"meta":277,"style":277},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","import { defineServerAuth } from '@onmax/nuxt-better-auth/config'\n\nexport default defineServerAuth({\n  emailAndPassword: {\n    enabled: true,\n  },\n})\n","ts",[175,343,344,368,375,393,406,421,427],{"__ignoreMap":277},[281,345,346,350,354,358,361,364],{"class":283,"line":284},[281,347,349],{"class":348},"sqe1H","import",[281,351,353],{"class":352},"sG9-4"," { ",[281,355,357],{"class":356},"sRQY5","defineServerAuth",[281,359,360],{"class":352}," } ",[281,362,363],{"class":348},"from",[281,365,367],{"class":366},"sU15n"," '@onmax/nuxt-better-auth/config'\n",[281,369,371],{"class":283,"line":370},2,[281,372,374],{"emptyLinePlaceholder":373},true,"\n",[281,376,378,381,385,389],{"class":283,"line":377},3,[281,379,380],{"class":348},"export",[281,382,384],{"class":383},"sKg8T"," default",[281,386,388],{"class":387},"sfT9l"," defineServerAuth",[281,390,392],{"class":391},"s17Py","({\n",[281,394,396,400,403],{"class":283,"line":395},4,[281,397,399],{"class":398},"sYvLG","  emailAndPassword",[281,401,311],{"class":402},"sVnqq",[281,404,405],{"class":391}," {\n",[281,407,409,412,414,418],{"class":283,"line":408},5,[281,410,411],{"class":398},"    enabled",[281,413,311],{"class":402},[281,415,417],{"class":416},"s3ZNE"," true",[281,419,420],{"class":391},",\n",[281,422,424],{"class":283,"line":423},6,[281,425,426],{"class":391},"  },\n",[281,428,430],{"class":283,"line":429},7,[281,431,432],{"class":391},"})\n",[267,434,436],{"id":435},"create-the-client-config","Create the client config",[272,438,440],{"className":339,"code":439,"filename":214,"language":341,"meta":277,"style":277},"import { defineClientAuth } from '@onmax/nuxt-better-auth/config'\n\nexport default defineClientAuth({})\n",[175,441,442,458,462],{"__ignoreMap":277},[281,443,444,446,448,451,453,455],{"class":283,"line":284},[281,445,349],{"class":348},[281,447,353],{"class":391},[281,449,450],{"class":398},"defineClientAuth",[281,452,360],{"class":391},[281,454,363],{"class":348},[281,456,367],{"class":457},"sPAZv",[281,459,460],{"class":283,"line":370},[281,461,374],{"emptyLinePlaceholder":373},[281,463,464,466,468,471],{"class":283,"line":377},[281,465,380],{"class":348},[281,467,384],{"class":383},[281,469,470],{"class":387}," defineClientAuth",[281,472,473],{"class":391},"({})\n",[267,475,477],{"id":476},"start-nuxt","Start Nuxt",[272,479,481],{"className":274,"code":480,"language":276,"meta":277,"style":277},"pnpm dev\n",[175,482,483],{"__ignoreMap":277},[281,484,485,487],{"class":283,"line":284},[281,486,177],{"class":287},[281,488,489],{"class":291}," dev\n",[197,491,493],{"id":492},"verify-the-result","Verify the result",[158,495,496],{},"Check these success signals:",[165,498,499,502,507,512],{},[168,500,501],{},"your app starts without auth-related module errors",[168,503,504,506],{},[175,505,220],{}," routes are registered",[168,508,509,511],{},[175,510,232],{}," is available in a page or component",[168,513,514],{},"the generated config files match your project structure",[158,516,517,518,521,522,195],{},"If you use a custom ",[175,519,520],{},"srcDir",", the client config lives there instead of ",[175,523,524],{},"app/",[197,526,528],{"id":527},"next-steps","Next steps",[530,531,532,539,546,553],"ol",{},[168,533,534,535,538],{},"Follow ",[185,536,537],{"href":14},"installation"," for the complete setup checklist.",[168,540,541,542,545],{},"Read ",[185,543,544],{"href":19},"configuration"," before adding providers or plugins.",[168,547,548,549,552],{},"Set up ",[185,550,551],{"href":24},"client usage"," in your pages and forms.",[168,554,555,556,559],{},"Add ",[185,557,558],{"href":57},"route protection"," once the login flow works.",[561,562,563],"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 .sG9-4, html code.shiki .sG9-4{--shiki-light:#A626A4;--shiki-default:#BBBBBB;--shiki-dark:#BBBBBB}html pre.shiki code .sRQY5, html code.shiki .sRQY5{--shiki-light:#A626A4;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .sU15n, html code.shiki .sU15n{--shiki-light:#A626A4;--shiki-default:#FF8B39;--shiki-dark:#FF8B39}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 .s3ZNE, html code.shiki .s3ZNE{--shiki-light:#986801;--shiki-default:#F97E72;--shiki-dark:#F97E72}html pre.shiki code .sPAZv, html code.shiki .sPAZv{--shiki-light:#50A14F;--shiki-default:#FF8B39;--shiki-dark:#FF8B39}",{"title":277,"searchDepth":370,"depth":370,"links":565},[566,567,568,575,576],{"id":199,"depth":370,"text":200},{"id":236,"depth":370,"text":237},{"id":261,"depth":370,"text":262,"children":569},[570,571,572,573,574],{"id":269,"depth":377,"text":270},{"id":304,"depth":377,"text":305},{"id":335,"depth":377,"text":336},{"id":435,"depth":377,"text":436},{"id":476,"depth":377,"text":477},{"id":492,"depth":370,"text":493},{"id":527,"depth":370,"text":528},"Nuxt Better Auth integrates Better Auth with Nuxt for route protection, session management, and schema generation.","md",null,{},{"icon":11},{"title":10,"description":577},"7_Yb8Fv7naqzqc9LiNZSaMQ-fyiyF9BIVMlwmVVqoo4",[579,585],{"title":13,"path":14,"stem":15,"description":586,"icon":16,"children":-1},"Learn how to add Nuxt Better Auth to your Nuxt project.",1777665183547]