[{"data":1,"prerenderedAt":683},["ShallowReactive",2],{"navigation_docs":3,"-guides-oauth-providers":152,"-guides-oauth-providers-surround":678},[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":78,"body":154,"description":672,"extension":673,"links":674,"meta":675,"navigation":289,"path":79,"seo":676,"stem":80,"__hash__":677},"docs/3.guides/2.oauth-providers.md",{"type":155,"value":156,"toc":664},"minimark",[157,161,166,619,624,627,656,660],[158,159,160],"p",{},"This guide demonstrates OAuth setup using Google. Other providers follow the same pattern.",[162,163],"read-more",{"title":164,"to":165},"Better Auth OAuth documentation","https://www.better-auth.com/docs/concepts/oauth",[167,168,169,174,207,224,228,247,254,409,413,570,598],"steps",{},[170,171,173],"h3",{"id":172},"create-a-google-oauth-app","Create a Google OAuth App",[175,176,177,188,191,198,204],"ol",{},[178,179,180,181],"li",{},"Go to ",[182,183,187],"a",{"href":184,"rel":185},"https://console.cloud.google.com/",[186],"nofollow","Google Cloud Console",[178,189,190],{},"Create a new project or select an existing one",[178,192,193,194],{},"Navigate to ",[195,196,197],"strong",{},"APIs & Services > Credentials",[178,199,200,201],{},"Click ",[195,202,203],{},"Create Credentials > OAuth client ID",[178,205,206],{},"Set the authorized redirect URI to:",[208,209,214],"pre",{"className":210,"code":211,"language":212,"meta":213,"style":213},"language-txt shiki shiki-themes one-light synthwave-84 synthwave-84","http://localhost:3000/api/auth/callback/google\n","txt","",[215,216,217],"code",{"__ignoreMap":213},[218,219,222],"span",{"class":220,"line":221},"line",1,[218,223,211],{},[170,225,227],{"id":226},"add-environment-variables","Add Environment Variables",[208,229,234],{"className":230,"code":231,"filename":232,"language":233,"meta":213,"style":213},"language-ini shiki shiki-themes one-light synthwave-84 synthwave-84","GOOGLE_CLIENT_ID=\"your-client-id\"\nGOOGLE_CLIENT_SECRET=\"your-client-secret\"\n",".env","ini",[215,235,236,241],{"__ignoreMap":213},[218,237,238],{"class":220,"line":221},[218,239,240],{},"GOOGLE_CLIENT_ID=\"your-client-id\"\n",[218,242,244],{"class":220,"line":243},2,[218,245,246],{},"GOOGLE_CLIENT_SECRET=\"your-client-secret\"\n",[170,248,250,251],{"id":249},"configure-serverauthconfigts","Configure ",[215,252,253],{},"server/auth.config.ts",[208,255,259],{"className":256,"code":257,"filename":253,"language":258,"meta":213,"style":213},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","import { defineServerAuth } from '@onmax/nuxt-better-auth/config'\n\nexport default defineServerAuth({\n  socialProviders: {\n    google: {\n      clientId: process.env.GOOGLE_CLIENT_ID as string,\n      clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,\n    },\n  },\n})\n","ts",[215,260,261,285,291,308,321,331,366,391,397,403],{"__ignoreMap":213},[218,262,263,267,271,275,278,281],{"class":220,"line":221},[218,264,266],{"class":265},"sqe1H","import",[218,268,270],{"class":269},"s17Py"," { ",[218,272,274],{"class":273},"sYvLG","defineServerAuth",[218,276,277],{"class":269}," } ",[218,279,280],{"class":265},"from",[218,282,284],{"class":283},"sPAZv"," '@onmax/nuxt-better-auth/config'\n",[218,286,287],{"class":220,"line":243},[218,288,290],{"emptyLinePlaceholder":289},true,"\n",[218,292,294,297,301,305],{"class":220,"line":293},3,[218,295,296],{"class":265},"export",[218,298,300],{"class":299},"sKg8T"," default",[218,302,304],{"class":303},"sfT9l"," defineServerAuth",[218,306,307],{"class":269},"({\n",[218,309,311,314,318],{"class":220,"line":310},4,[218,312,313],{"class":273},"  socialProviders",[218,315,317],{"class":316},"sVnqq",":",[218,319,320],{"class":269}," {\n",[218,322,324,327,329],{"class":220,"line":323},5,[218,325,326],{"class":273},"    google",[218,328,317],{"class":316},[218,330,320],{"class":269},[218,332,334,337,339,343,346,349,351,355,359,363],{"class":220,"line":333},6,[218,335,336],{"class":273},"      clientId",[218,338,317],{"class":316},[218,340,342],{"class":341},"svFNh"," process",[218,344,345],{"class":269},".",[218,347,348],{"class":273},"env",[218,350,345],{"class":269},[218,352,354],{"class":353},"s6Rhl","GOOGLE_CLIENT_ID",[218,356,358],{"class":357},"snT_2"," as",[218,360,362],{"class":361},"sr8De"," string",[218,364,365],{"class":269},",\n",[218,367,369,372,374,376,378,380,382,385,387,389],{"class":220,"line":368},7,[218,370,371],{"class":273},"      clientSecret",[218,373,317],{"class":316},[218,375,342],{"class":341},[218,377,345],{"class":269},[218,379,348],{"class":273},[218,381,345],{"class":269},[218,383,384],{"class":353},"GOOGLE_CLIENT_SECRET",[218,386,358],{"class":357},[218,388,362],{"class":361},[218,390,365],{"class":269},[218,392,394],{"class":220,"line":393},8,[218,395,396],{"class":269},"    },\n",[218,398,400],{"class":220,"line":399},9,[218,401,402],{"class":269},"  },\n",[218,404,406],{"class":220,"line":405},10,[218,407,408],{"class":269},"})\n",[170,410,412],{"id":411},"add-a-sign-in-button","Add a Sign-In Button",[208,414,419],{"className":415,"code":416,"filename":417,"language":418,"meta":213,"style":213},"language-vue shiki shiki-themes one-light synthwave-84 synthwave-84","\u003Cscript setup lang=\"ts\">\ndefinePageMeta({ auth: 'guest' })\nconst { signIn } = useUserSession()\n\u003C/script>\n\n\u003Ctemplate>\n  \u003Cbutton\n    type=\"button\"\n    @click=\"signIn.social({ provider: 'google' })\"\n  >\n    Continue with Google\n  \u003C/button>\n\u003C/template>\n","pages/login.vue","vue",[215,420,421,448,468,489,498,502,511,519,529,539,544,550,561],{"__ignoreMap":213},[218,422,423,427,431,435,438,442,445],{"class":220,"line":221},[218,424,426],{"class":425},"sL9le","\u003C",[218,428,430],{"class":429},"stweg","script",[218,432,434],{"class":433},"s0frj"," setup",[218,436,437],{"class":433}," lang",[218,439,441],{"class":440},"sNM9w","=",[218,443,444],{"class":283},"\"ts\"",[218,446,447],{"class":425},">\n",[218,449,450,453,457,460,462,465],{"class":220,"line":243},[218,451,452],{"class":303},"definePageMeta",[218,454,456],{"class":455},"sEEOt","({ ",[218,458,459],{"class":273},"auth",[218,461,317],{"class":316},[218,463,464],{"class":283}," 'guest'",[218,466,467],{"class":455}," })\n",[218,469,470,473,475,478,480,483,486],{"class":220,"line":293},[218,471,472],{"class":265},"const",[218,474,270],{"class":455},[218,476,477],{"class":353},"signIn",[218,479,277],{"class":455},[218,481,441],{"class":482},"sQBpM",[218,484,485],{"class":303}," useUserSession",[218,487,488],{"class":455},"()\n",[218,490,491,494,496],{"class":220,"line":310},[218,492,493],{"class":425},"\u003C/",[218,495,430],{"class":429},[218,497,447],{"class":425},[218,499,500],{"class":220,"line":323},[218,501,290],{"emptyLinePlaceholder":289},[218,503,504,506,509],{"class":220,"line":333},[218,505,426],{"class":425},[218,507,508],{"class":429},"template",[218,510,447],{"class":425},[218,512,513,516],{"class":220,"line":368},[218,514,515],{"class":425},"  \u003C",[218,517,518],{"class":429},"button\n",[218,520,521,524,526],{"class":220,"line":393},[218,522,523],{"class":433},"    type",[218,525,441],{"class":440},[218,527,528],{"class":283},"\"button\"\n",[218,530,531,534,536],{"class":220,"line":399},[218,532,533],{"class":433},"    @click",[218,535,441],{"class":440},[218,537,538],{"class":283},"\"signIn.social({ provider: 'google' })\"\n",[218,540,541],{"class":220,"line":405},[218,542,543],{"class":425},"  >\n",[218,545,547],{"class":220,"line":546},11,[218,548,549],{"class":455},"    Continue with Google\n",[218,551,553,556,559],{"class":220,"line":552},12,[218,554,555],{"class":425},"  \u003C/",[218,557,558],{"class":429},"button",[218,560,447],{"class":425},[218,562,564,566,568],{"class":220,"line":563},13,[218,565,493],{"class":425},[218,567,508],{"class":429},[218,569,447],{"class":425},[571,572,573,574,577,578,581,582,585,586,589,590,593,594,597],"tip",{},"For OAuth flows (",[215,575,576],{},"signIn.social","), Better Auth handles the browser redirect to the provider.\nNo manual ",[215,579,580],{},"fetchSession","/",[215,583,584],{},"waitForSession"," step is needed before that redirect.\n",[215,587,588],{},"callbackURL"," is optional. When your app configures ",[215,591,592],{},"auth.redirects.authenticated"," (or has a safe ",[215,595,596],{},"?redirect="," query), the module can use that as the fallback callback URL.",[599,600,601,604,616],"important",{},[158,602,603],{},"OAuth can work without a database using stateless (JWE) session cookies, but there are tradeoffs:",[605,606,607,610,613],"ul",{},[178,608,609],{},"No persistent account/session management (cannot list or revoke sessions)",[178,611,612],{},"Limited server-side visibility into linked accounts",[178,614,615],{},"You must accept that account state lives in encrypted cookies",[158,617,618],{},"If you need durable account records or admin/session management, use a database-backed setup.",[620,621,623],"h2",{"id":622},"other-providers","Other Providers",[158,625,626],{},"Better Auth supports 20+ providers (Apple, Discord, Facebook, etc). The pattern is identical:",[175,628,629,632,645,650],{},[178,630,631],{},"Create OAuth app, get client ID/secret",[178,633,634,635,638,639,642,643],{},"Add ",[215,636,637],{},"{PROVIDER}_CLIENT_ID"," and ",[215,640,641],{},"{PROVIDER}_CLIENT_SECRET"," to ",[215,644,232],{},[178,646,647,648],{},"Reference credentials in ",[215,649,253],{},[178,651,652,653],{},"Call ",[215,654,655],{},"signIn.social({ provider: 'providerId' })",[162,657],{"title":658,"to":659},"Full provider list","https://www.better-auth.com/docs/authentication/other-social-providers",[661,662,663],"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 .sqe1H, html code.shiki .sqe1H{--shiki-light:#A626A4;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}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 .sPAZv, html code.shiki .sPAZv{--shiki-light:#50A14F;--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 .sVnqq, html code.shiki .sVnqq{--shiki-light:#0184BC;--shiki-default:#B6B1B1;--shiki-dark:#B6B1B1}html pre.shiki code .svFNh, html code.shiki .svFNh{--shiki-light:#383A42;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .s6Rhl, html code.shiki .s6Rhl{--shiki-light:#986801;--shiki-default:#FF7EDB;--shiki-dark:#FF7EDB}html pre.shiki code .snT_2, html code.shiki .snT_2{--shiki-light:#383A42;--shiki-default:#FEDE5D;--shiki-dark:#FEDE5D}html pre.shiki code .sr8De, html code.shiki .sr8De{--shiki-light:#0184BC;--shiki-default:#FE4450;--shiki-dark:#FE4450}html pre.shiki code .sL9le, html code.shiki .sL9le{--shiki-light:#383A42;--shiki-default:#36F9F6;--shiki-dark:#36F9F6}html pre.shiki code .stweg, html code.shiki .stweg{--shiki-light:#E45649;--shiki-default:#72F1B8;--shiki-dark:#72F1B8}html pre.shiki code .s0frj, html code.shiki .s0frj{--shiki-light:#986801;--shiki-light-font-style:inherit;--shiki-default:#FEDE5D;--shiki-default-font-style:italic;--shiki-dark:#FEDE5D;--shiki-dark-font-style:italic}html pre.shiki code .sNM9w, html code.shiki .sNM9w{--shiki-light:#383A42;--shiki-default:#B6B1B1;--shiki-dark:#B6B1B1}html pre.shiki code .sEEOt, html code.shiki .sEEOt{--shiki-light:#383A42;--shiki-default:#FFFFFFEE;--shiki-dark:#FFFFFFEE}html pre.shiki code .sQBpM, html code.shiki .sQBpM{--shiki-light:#0184BC;--shiki-default:#FFFFFFEE;--shiki-dark:#FFFFFFEE}",{"title":213,"searchDepth":243,"depth":243,"links":665},[666,667,668,670,671],{"id":172,"depth":293,"text":173},{"id":226,"depth":293,"text":227},{"id":249,"depth":293,"text":669},"Configure server/auth.config.ts",{"id":411,"depth":293,"text":412},{"id":622,"depth":243,"text":623},"Configure OAuth providers and sign in with `signIn.social()`.","md",null,{},{"title":78,"description":672},"AY65r-6XuD_PdDx1dMSFzyGlOgSNatl7NIPk6IzcMas",[679,681],{"title":74,"path":75,"stem":76,"description":680,"children":-1},"Protect routes using generic field matching on AuthUser.",{"title":82,"path":83,"stem":84,"description":682,"children":-1},"Use your own database with Drizzle, Prisma, or Kysely adapters.",1774627855157]