[{"data":1,"prerenderedAt":527},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-schema-generation":152,"-getting-started-schema-generation-surround":522},[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":154,"body":155,"description":515,"extension":516,"links":517,"meta":518,"navigation":519,"path":34,"seo":520,"stem":35,"__hash__":521},"docs/1.getting-started/5.schema-generation.md","Schema Generation",{"type":156,"value":157,"toc":509},"minimark",[158,223,227,240,243,248,263,289,293,297,300,319,326,402,406,412,464,468,471,486,492,498,505],[159,160,161],"code-collapse",{},[162,163,169],"pre",{"className":164,"code":165,"filename":166,"language":167,"meta":168,"style":168},"language-txt shiki shiki-themes one-light synthwave-84 synthwave-84","Set up auto schema generation for @onmax/nuxt-better-auth with NuxtHub.\n\n- Requires NuxtHub integration — the module generates Drizzle ORM schemas at build time\n- Supports sqlite (default), postgresql, and mysql dialects via `hub.db.dialect` in `nuxt.config.ts`\n- The module reads `server/auth.config.ts` plugins to determine required tables (user, session, account, verification + plugin tables)\n- After adding/removing plugins: restart the dev server to regenerate schemas\n- For production (Cloudflare D1): run `npx nuxt db migrate`\n- No manual Drizzle schema writing needed for auth tables\n","Prompt","txt","",[170,171,172,180,187,193,199,205,211,217],"code",{"__ignoreMap":168},[173,174,177],"span",{"class":175,"line":176},"line",1,[173,178,179],{},"Set up auto schema generation for @onmax/nuxt-better-auth with NuxtHub.\n",[173,181,183],{"class":175,"line":182},2,[173,184,186],{"emptyLinePlaceholder":185},true,"\n",[173,188,190],{"class":175,"line":189},3,[173,191,192],{},"- Requires NuxtHub integration — the module generates Drizzle ORM schemas at build time\n",[173,194,196],{"class":175,"line":195},4,[173,197,198],{},"- Supports sqlite (default), postgresql, and mysql dialects via `hub.db.dialect` in `nuxt.config.ts`\n",[173,200,202],{"class":175,"line":201},5,[173,203,204],{},"- The module reads `server/auth.config.ts` plugins to determine required tables (user, session, account, verification + plugin tables)\n",[173,206,208],{"class":175,"line":207},6,[173,209,210],{},"- After adding/removing plugins: restart the dev server to regenerate schemas\n",[173,212,214],{"class":175,"line":213},7,[173,215,216],{},"- For production (Cloudflare D1): run `npx nuxt db migrate`\n",[173,218,220],{"class":175,"line":219},8,[173,221,222],{},"- No manual Drizzle schema writing needed for auth tables\n",[224,225,226],"p",{},"Use this page when you are using NuxtHub and want the module to generate auth tables from your Better Auth configuration.",[228,229,230,231,234,235,239],"note",{},"This feature requires ",[232,233,116],"strong",{},". See ",[236,237,238],"a",{"href":117},"NuxtHub Integration"," for setup.",[224,241,242],{},"Better Auth requires tables for users, sessions, accounts. This module creates them automatically with NuxtHub and Drizzle ORM.",[244,245,247],"h2",{"id":246},"how-it-works","How it works",[224,249,250,251,254,255,258,259,262],{},"The module analyzes your ",[170,252,253],{},"server/auth.config.ts"," at build time to determine which tables are required by your core configuration and enabled plugins (e.g., ",[170,256,257],{},"twoFactor",", ",[170,260,261],{},"passkey",").",[264,265,266,277,283],"ol",{},[267,268,269,272,273,276],"li",{},[232,270,271],{},"Analysis",": Reads ",[170,274,275],{},"plugins"," from your config.",[267,278,279,282],{},[232,280,281],{},"Generation",": Generates a Drizzle schema file corresponding to your database dialect (SQLite, PostgreSQL, MySQL).",[267,284,285,288],{},[232,286,287],{},"Integration",": Automatically injects this schema into NuxtHub's database configuration.",[290,291,292],"tip",{},"You do not need to manually write Drizzle schemas for authentication tables.",[244,294,296],{"id":295},"supported-dialects","Supported Dialects",[224,298,299],{},"The module supports all dialects compatible with NuxtHub:",[301,302,303,309,314],"ul",{},[267,304,305,308],{},[170,306,307],{},"sqlite"," (Default)",[267,310,311],{},[170,312,313],{},"postgresql",[267,315,316],{},[170,317,318],{},"mysql",[224,320,321,322,325],{},"Ensure you have configured the dialect in ",[170,323,324],{},"nuxt.config.ts",":",[162,327,331],{"className":328,"code":329,"filename":324,"language":330,"meta":168,"style":168},"language-ts shiki shiki-themes one-light synthwave-84 synthwave-84","export default defineNuxtConfig({\n  hub: {\n    db: {\n      dialect: 'postgresql' // or 'sqlite', 'mysql'\n    }\n  }\n})\n","ts",[170,332,333,351,363,372,387,392,397],{"__ignoreMap":168},[173,334,335,339,343,347],{"class":175,"line":176},[173,336,338],{"class":337},"sqe1H","export",[173,340,342],{"class":341},"sKg8T"," default",[173,344,346],{"class":345},"sfT9l"," defineNuxtConfig",[173,348,350],{"class":349},"s17Py","({\n",[173,352,353,357,360],{"class":175,"line":182},[173,354,356],{"class":355},"sYvLG","  hub",[173,358,325],{"class":359},"sVnqq",[173,361,362],{"class":349}," {\n",[173,364,365,368,370],{"class":175,"line":189},[173,366,367],{"class":355},"    db",[173,369,325],{"class":359},[173,371,362],{"class":349},[173,373,374,377,379,383],{"class":175,"line":195},[173,375,376],{"class":355},"      dialect",[173,378,325],{"class":359},[173,380,382],{"class":381},"sPAZv"," 'postgresql'",[173,384,386],{"class":385},"st7cf"," // or 'sqlite', 'mysql'\n",[173,388,389],{"class":175,"line":201},[173,390,391],{"class":349},"    }\n",[173,393,394],{"class":175,"line":207},[173,395,396],{"class":349},"  }\n",[173,398,399],{"class":175,"line":213},[173,400,401],{"class":349},"})\n",[244,403,405],{"id":404},"workflow","Workflow",[224,407,408,409,411],{},"When you add a new plugin that requires database tables (e.g., adding ",[170,410,257],{},"):",[264,413,414,420,423,426,429],{},[267,415,416,417,419],{},"Update ",[170,418,253],{},".",[267,421,422],{},"Restart your development server.",[267,424,425],{},"The module regenerates the schema.",[267,427,428],{},"If using NuxtHub local development, the tables are ready.",[267,430,431,434,437,438,440,441],{},[232,432,433],{},"Deploy with migrations:",[435,436],"br",{},"For local development, migrations run automatically when you start the dev server.",[435,439],{},"For production (Cloudflare D1):",[162,442,446],{"className":443,"code":444,"language":445,"meta":168,"style":168},"language-bash shiki shiki-themes one-light synthwave-84 synthwave-84","npx nuxt db migrate\n","bash",[170,447,448],{"__ignoreMap":168},[173,449,450,454,458,461],{"class":175,"line":176},[173,451,453],{"class":452},"siqUp","npx",[173,455,457],{"class":456},"sI3kV"," nuxt",[173,459,460],{"class":456}," db",[173,462,463],{"class":456}," migrate\n",[244,465,467],{"id":466},"when-not-to-use-this","When not to use this",[224,469,470],{},"Do not rely on this flow if:",[301,472,473,476,483],{},[267,474,475],{},"you are not using NuxtHub",[267,477,478,479,482],{},"you are in ",[170,480,481],{},"clientOnly"," mode",[267,484,485],{},"you manage Better Auth tables with a separate adapter and migration pipeline",[224,487,488,489,419],{},"In those cases, use ",[236,490,491],{"href":83},"custom database setup",[493,494,497],"callout",{":external":495,"to":496},"true","https://hub.nuxt.com/docs/getting-started/deploy","See NuxtHub deployment documentation.",[499,500,501,504],"warning",{},[232,502,503],{},"Restart Required",": Because schema generation happens at build/module-setup time, you must restart the dev server after adding or removing plugins that affect the database structure.",[506,507,508],"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 .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 .st7cf, html code.shiki .st7cf{--shiki-light:#A0A1A7;--shiki-light-font-style:italic;--shiki-default:#848BBD;--shiki-default-font-style:italic;--shiki-dark:#848BBD;--shiki-dark-font-style:italic}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}",{"title":168,"searchDepth":182,"depth":182,"links":510},[511,512,513,514],{"id":246,"depth":182,"text":247},{"id":295,"depth":182,"text":296},{"id":404,"depth":182,"text":405},{"id":466,"depth":182,"text":467},"Auto-generate Drizzle ORM schemas for Better Auth tables when using NuxtHub.","md",null,{},{"title":33,"icon":36},{"title":154,"description":515},"ca4uJInNraVmVD7URmHojQ70rzjCTYHhkieAotAjCRI",[523,525],{"title":28,"path":29,"stem":30,"description":524,"icon":31,"children":-1},"Learn how the module automatically infers types from your configuration.",{"title":38,"path":39,"stem":40,"description":526,"icon":41,"children":-1},"Understand the architecture after completing setup.",1777451671474]