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