[{"data":1,"prerenderedAt":1198},["ShallowReactive",2],{"navigation_docs":3,"-get-started-database":587,"-get-started-database-surround":1193},[4,50,155,441,504],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":49},"Get Started","i-lucide-rocket","\u002Fget-started","1.get-started",[10,15,20,25,30,35,40,45],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fget-started\u002Fintroduction","1.get-started\u002F1.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Installation","\u002Fget-started\u002Finstallation","1.get-started\u002F2.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Project structure","\u002Fget-started\u002Fproject-structure","1.get-started\u002F3.project-structure","i-lucide-folder-tree",{"title":26,"path":27,"stem":28,"icon":29},"Configuration","\u002Fget-started\u002Fconfiguration","1.get-started\u002F4.configuration","i-lucide-settings",{"title":31,"path":32,"stem":33,"icon":34},"Authentication","\u002Fget-started\u002Fauthentication","1.get-started\u002F5.authentication","i-lucide-lock",{"title":36,"path":37,"stem":38,"icon":39},"Adding modules","\u002Fget-started\u002Fadding-modules","1.get-started\u002F6.adding-modules","i-lucide-puzzle",{"title":41,"path":42,"stem":43,"icon":44},"Database","\u002Fget-started\u002Fdatabase","1.get-started\u002F7.database","i-lucide-database",{"title":46,"path":47,"stem":48,"icon":6},"Deployment","\u002Fget-started\u002Fdeployment","1.get-started\u002F8.deployment",false,{"title":51,"icon":52,"path":53,"stem":54,"children":55,"page":49},"Guide","i-lucide-book-open","\u002Fguide","2.guide",[56,90,115,125],{"title":57,"icon":49,"path":58,"stem":59,"children":60,"page":49},"Concepts","\u002Fguide\u002Fconcepts","2.guide\u002F1.concepts",[61,66,71,76,80,85],{"title":62,"path":63,"stem":64,"icon":65},"Architecture","\u002Fguide\u002Fconcepts\u002Farchitecture","2.guide\u002F1.concepts\u002F1.architecture","i-lucide-blocks",{"title":67,"path":68,"stem":69,"icon":70},"Access control","\u002Fguide\u002Fconcepts\u002Fauth-and-scopes","2.guide\u002F1.concepts\u002F2.auth-and-scopes","i-lucide-shield-check",{"title":72,"path":73,"stem":74,"icon":75},"Extension points","\u002Fguide\u002Fconcepts\u002Fextension-points","2.guide\u002F1.concepts\u002F3.extension-points","i-lucide-plug",{"title":77,"path":78,"stem":79,"icon":44},"Database extensions","\u002Fguide\u002Fconcepts\u002Fdatabase-extensions","2.guide\u002F1.concepts\u002F4.database-extensions",{"title":81,"path":82,"stem":83,"icon":84},"Identity","\u002Fguide\u002Fconcepts\u002Fidentity","2.guide\u002F1.concepts\u002F5.identity","i-lucide-fingerprint",{"title":86,"path":87,"stem":88,"icon":89},"Glossary","\u002Fguide\u002Fconcepts\u002Fglossary","2.guide\u002F1.concepts\u002F6.glossary","i-lucide-book-a",{"title":91,"icon":49,"path":92,"stem":93,"children":94,"page":49},"UX patterns","\u002Fguide\u002Fux-patterns","2.guide\u002F2.ux-patterns",[95,100,105,110],{"title":96,"path":97,"stem":98,"icon":99},"Layouts and navigation","\u002Fguide\u002Fux-patterns\u002Flayouts-and-navigation","2.guide\u002F2.ux-patterns\u002F1.layouts-and-navigation","i-lucide-layout-template",{"title":101,"path":102,"stem":103,"icon":104},"Pages","\u002Fguide\u002Fux-patterns\u002Fpages","2.guide\u002F2.ux-patterns\u002F2.pages","i-lucide-table",{"title":106,"path":107,"stem":108,"icon":109},"Forms and actions","\u002Fguide\u002Fux-patterns\u002Fforms-and-actions","2.guide\u002F2.ux-patterns\u002F3.forms-and-actions","i-lucide-square-pen",{"title":111,"path":112,"stem":113,"icon":114},"Text and formatting","\u002Fguide\u002Fux-patterns\u002Ftext-and-formatting","2.guide\u002F2.ux-patterns\u002F4.text-and-formatting","i-lucide-type",{"title":116,"icon":49,"path":117,"stem":118,"children":119,"page":49},"Best practices","\u002Fguide\u002Fbest-practices","2.guide\u002F3.best-practices",[120],{"title":121,"path":122,"stem":123,"icon":124},"HTTP routes","\u002Fguide\u002Fbest-practices\u002Fhttp-routes","2.guide\u002F3.best-practices\u002F1.http-routes","i-lucide-route",{"title":126,"icon":49,"path":127,"stem":128,"children":129,"page":49},"Going further","\u002Fguide\u002Fgoing-further","2.guide\u002F4.going-further",[130,135,140,145,150],{"title":131,"path":132,"stem":133,"icon":134},"Use your own OAuth server","\u002Fguide\u002Fgoing-further\u002Fown-oauth-server","2.guide\u002F4.going-further\u002F1.own-oauth-server","i-lucide-key-round",{"title":136,"path":137,"stem":138,"icon":139},"Create an OAuth application","\u002Fguide\u002Fgoing-further\u002Foauth-application","2.guide\u002F4.going-further\u002F2.oauth-application","i-lucide-app-window",{"title":141,"path":142,"stem":143,"icon":144},"Signing keys","\u002Fguide\u002Fgoing-further\u002Fsigning-keys","2.guide\u002F4.going-further\u002F3.signing-keys","i-lucide-key-square",{"title":146,"path":147,"stem":148,"icon":149},"Stripe setup","\u002Fguide\u002Fgoing-further\u002Fstripe-setup","2.guide\u002F4.going-further\u002F4.stripe-setup","i-lucide-credit-card",{"title":151,"path":152,"stem":153,"icon":154},"Migrate to the permission model","\u002Fguide\u002Fgoing-further\u002Fmigrate-access-control","2.guide\u002F4.going-further\u002F5.migrate-access-control","i-lucide-arrow-right-left",{"title":156,"icon":157,"path":158,"stem":159,"children":160},"Modules","i-lucide-boxes","\u002Fmodules","3.modules",[161,163,244,273,320,375],{"title":156,"path":158,"stem":162},"3.modules\u002Findex",{"title":81,"icon":49,"path":164,"stem":165,"children":166,"page":49},"\u002Fmodules\u002Fidentity","3.modules\u002F1.identity",[167,190,194,198,220,224,240],{"title":168,"path":169,"stem":170,"children":171},"Auth","\u002Fmodules\u002Fidentity\u002Fauth","3.modules\u002F1.identity\u002F1.auth\u002Findex",[172,174,178,182,186],{"title":173,"path":169,"stem":170},"Overview",{"title":175,"path":176,"stem":177},"Server API","\u002Fmodules\u002Fidentity\u002Fauth\u002Fserver","3.modules\u002F1.identity\u002F1.auth\u002F2.server",{"title":179,"path":180,"stem":181},"Reference","\u002Fmodules\u002Fidentity\u002Fauth\u002Freference","3.modules\u002F1.identity\u002F1.auth\u002F3.reference",{"title":183,"path":184,"stem":185},"Client mode","\u002Fmodules\u002Fidentity\u002Fauth\u002Fclient-mode","3.modules\u002F1.identity\u002F1.auth\u002F4.client-mode",{"title":187,"path":188,"stem":189},"OAuth providers","\u002Fmodules\u002Fidentity\u002Fauth\u002Foauth-providers","3.modules\u002F1.identity\u002F1.auth\u002F5.oauth-providers",{"title":191,"path":192,"stem":193},"Users","\u002Fmodules\u002Fidentity\u002Fusers","3.modules\u002F1.identity\u002F2.users",{"title":195,"path":196,"stem":197},"Account","\u002Fmodules\u002Fidentity\u002Faccount","3.modules\u002F1.identity\u002F3.account",{"title":199,"path":200,"stem":201,"children":202},"Authorization","\u002Fmodules\u002Fidentity\u002Fauthorization","3.modules\u002F1.identity\u002F4.authorization\u002Findex",[203,204,208,212,216],{"title":173,"path":200,"stem":201},{"title":205,"path":206,"stem":207},"Roles and requirements","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Froles-and-requirements","3.modules\u002F1.identity\u002F4.authorization\u002F2.roles-and-requirements",{"title":209,"path":210,"stem":211},"Policies","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Fpolicies","3.modules\u002F1.identity\u002F4.authorization\u002F3.policies",{"title":213,"path":214,"stem":215},"Client","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Fclient","3.modules\u002F1.identity\u002F4.authorization\u002F4.client",{"title":217,"path":218,"stem":219},"Admin","\u002Fmodules\u002Fidentity\u002Fauthorization\u002Fadmin","3.modules\u002F1.identity\u002F4.authorization\u002F5.admin",{"title":221,"path":222,"stem":223},"Preferences","\u002Fmodules\u002Fidentity\u002Fpreferences","3.modules\u002F1.identity\u002F5.preferences",{"title":225,"path":226,"stem":227,"children":228},"OAuth Server","\u002Fmodules\u002Fidentity\u002Foauth-server","3.modules\u002F1.identity\u002F6.oauth-server\u002Findex",[229,230,233,237],{"title":173,"path":226,"stem":227},{"title":175,"path":231,"stem":232},"\u002Fmodules\u002Fidentity\u002Foauth-server\u002Fserver","3.modules\u002F1.identity\u002F6.oauth-server\u002F2.server",{"title":234,"path":235,"stem":236},"Hooks","\u002Fmodules\u002Fidentity\u002Foauth-server\u002Fhooks","3.modules\u002F1.identity\u002F6.oauth-server\u002F3.hooks",{"title":179,"path":238,"stem":239},"\u002Fmodules\u002Fidentity\u002Foauth-server\u002Froutes-and-clients","3.modules\u002F1.identity\u002F6.oauth-server\u002F4.routes-and-clients",{"title":241,"path":242,"stem":243},"OAuth Resource","\u002Fmodules\u002Fidentity\u002Foauth-resource","3.modules\u002F1.identity\u002F8.oauth-resource",{"title":245,"icon":49,"path":246,"stem":247,"children":248,"page":49},"Commerce","\u002Fmodules\u002Fcommerce","3.modules\u002F2.commerce",[249,253,257],{"title":250,"path":251,"stem":252},"Stripe","\u002Fmodules\u002Fcommerce\u002Fstripe","3.modules\u002F2.commerce\u002F1.stripe",{"title":254,"path":255,"stem":256},"Payments","\u002Fmodules\u002Fcommerce\u002Fpayments","3.modules\u002F2.commerce\u002F2.payments",{"title":258,"path":259,"stem":260,"children":261},"Subscriptions","\u002Fmodules\u002Fcommerce\u002Fsubscriptions","3.modules\u002F2.commerce\u002F3.subscriptions\u002Findex",[262,263,266,270],{"title":173,"path":259,"stem":260},{"title":175,"path":264,"stem":265},"\u002Fmodules\u002Fcommerce\u002Fsubscriptions\u002Fserver","3.modules\u002F2.commerce\u002F3.subscriptions\u002F2.server",{"title":267,"path":268,"stem":269},"App","\u002Fmodules\u002Fcommerce\u002Fsubscriptions\u002Fapp","3.modules\u002F2.commerce\u002F3.subscriptions\u002F3.app",{"title":179,"path":271,"stem":272},"\u002Fmodules\u002Fcommerce\u002Fsubscriptions\u002Freference","3.modules\u002F2.commerce\u002F3.subscriptions\u002F4.reference",{"title":274,"icon":49,"path":275,"stem":276,"children":277,"page":49},"Features","\u002Fmodules\u002Ffeatures","3.modules\u002F3.features",[278,293,312,316],{"title":279,"path":280,"stem":281,"children":282},"Events","\u002Fmodules\u002Ffeatures\u002Fevents","3.modules\u002F3.features\u002F1.events\u002Findex",[283,284,287,290],{"title":173,"path":280,"stem":281},{"title":175,"path":285,"stem":286},"\u002Fmodules\u002Ffeatures\u002Fevents\u002Fserver","3.modules\u002F3.features\u002F1.events\u002F2.server",{"title":267,"path":288,"stem":289},"\u002Fmodules\u002Ffeatures\u002Fevents\u002Fapp","3.modules\u002F3.features\u002F1.events\u002F3.app",{"title":179,"path":291,"stem":292},"\u002Fmodules\u002Ffeatures\u002Fevents\u002Freference","3.modules\u002F3.features\u002F1.events\u002F4.reference",{"title":294,"path":295,"stem":296,"children":297},"Forms","\u002Fmodules\u002Ffeatures\u002Fforms","3.modules\u002F3.features\u002F2.forms\u002Findex",[298,299,303,306,309],{"title":173,"path":295,"stem":296},{"title":300,"path":301,"stem":302},"Definition","\u002Fmodules\u002Ffeatures\u002Fforms\u002Fdefinition","3.modules\u002F3.features\u002F2.forms\u002F2.definition",{"title":175,"path":304,"stem":305},"\u002Fmodules\u002Ffeatures\u002Fforms\u002Fserver","3.modules\u002F3.features\u002F2.forms\u002F3.server",{"title":267,"path":307,"stem":308},"\u002Fmodules\u002Ffeatures\u002Fforms\u002Fapp","3.modules\u002F3.features\u002F2.forms\u002F4.app",{"title":179,"path":310,"stem":311},"\u002Fmodules\u002Ffeatures\u002Fforms\u002Freference","3.modules\u002F3.features\u002F2.forms\u002F5.reference",{"title":313,"path":314,"stem":315},"Cookie Consent","\u002Fmodules\u002Ffeatures\u002Fcookie-consent","3.modules\u002F3.features\u002F3.cookie-consent",{"title":317,"path":318,"stem":319},"MCP","\u002Fmodules\u002Ffeatures\u002Fmcp","3.modules\u002F3.features\u002F4.mcp",{"title":321,"icon":49,"path":322,"stem":323,"children":324,"page":49},"Interface","\u002Fmodules\u002Finterface","3.modules\u002F4.interface",[325,350,353,357,361],{"title":326,"path":327,"stem":328,"children":329},"UI","\u002Fmodules\u002Finterface\u002Fui","3.modules\u002F4.interface\u002F1.ui\u002Findex",[330,331,335,339,343,347],{"title":173,"path":327,"stem":328},{"title":332,"path":333,"stem":334},"Page components","\u002Fmodules\u002Finterface\u002Fui\u002Fpage-components","3.modules\u002F4.interface\u002F1.ui\u002F2.page-components",{"title":336,"path":337,"stem":338},"App shell","\u002Fmodules\u002Finterface\u002Fui\u002Fapp-shell","3.modules\u002F4.interface\u002F1.ui\u002F3.app-shell",{"title":340,"path":341,"stem":342},"Form inputs","\u002Fmodules\u002Finterface\u002Fui\u002Fform-inputs","3.modules\u002F4.interface\u002F1.ui\u002F4.form-inputs",{"title":344,"path":345,"stem":346},"Composables and helpers","\u002Fmodules\u002Finterface\u002Fui\u002Fcomposables","3.modules\u002F4.interface\u002F1.ui\u002F5.composables",{"title":179,"path":348,"stem":349},"\u002Fmodules\u002Finterface\u002Fui\u002Freference","3.modules\u002F4.interface\u002F1.ui\u002F6.reference",{"title":217,"path":351,"stem":352},"\u002Fmodules\u002Finterface\u002Fadmin","3.modules\u002F4.interface\u002F2.admin",{"title":354,"path":355,"stem":356},"Menu","\u002Fmodules\u002Finterface\u002Fmenu","3.modules\u002F4.interface\u002F3.menu",{"title":358,"path":359,"stem":360},"Widget","\u002Fmodules\u002Finterface\u002Fwidget","3.modules\u002F4.interface\u002F4.widget",{"title":362,"path":363,"stem":364,"children":365},"Mobile","\u002Fmodules\u002Finterface\u002Fmobile","3.modules\u002F4.interface\u002F5.mobile\u002Findex",[366,367,371],{"title":173,"path":363,"stem":364},{"title":368,"path":369,"stem":370},"CLI and devices","\u002Fmodules\u002Finterface\u002Fmobile\u002Fcli-and-devices","3.modules\u002F4.interface\u002F5.mobile\u002F2.cli-and-devices",{"title":372,"path":373,"stem":374},"Splash screen","\u002Fmodules\u002Finterface\u002Fmobile\u002Fsplash-screen","3.modules\u002F4.interface\u002F5.mobile\u002F3.splash-screen",{"title":376,"icon":49,"path":377,"stem":378,"children":379,"page":49},"Platform","\u002Fmodules\u002Fplatform","3.modules\u002F5.platform",[380,402,406,423],{"title":381,"path":382,"stem":383,"children":384},"Module Kit","\u002Fmodules\u002Fplatform\u002Fmodule-kit","3.modules\u002F5.platform\u002F1.module-kit\u002Findex",[385,386,390,394,398],{"title":173,"path":382,"stem":383},{"title":387,"path":388,"stem":389},"Server toolkit","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fserver-toolkit","3.modules\u002F5.platform\u002F1.module-kit\u002F2.server-toolkit",{"title":391,"path":392,"stem":393},"Registries and menus","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fregistries-and-menus","3.modules\u002F5.platform\u002F1.module-kit\u002F3.registries-and-menus",{"title":395,"path":396,"stem":397},"Translations","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fi18n","3.modules\u002F5.platform\u002F1.module-kit\u002F4.i18n",{"title":399,"path":400,"stem":401},"Database helpers","\u002Fmodules\u002Fplatform\u002Fmodule-kit\u002Fdatabase","3.modules\u002F5.platform\u002F1.module-kit\u002F5.database",{"title":403,"path":404,"stem":405},"Notify","\u002Fmodules\u002Fplatform\u002Fnotify","3.modules\u002F5.platform\u002F2.notify",{"title":407,"path":408,"stem":409,"children":410},"Email Templates","\u002Fmodules\u002Fplatform\u002Femail-templates","3.modules\u002F5.platform\u002F3.email-templates\u002Findex",[411,412,416,419],{"title":173,"path":408,"stem":409},{"title":413,"path":414,"stem":415},"Email components","\u002Fmodules\u002Fplatform\u002Femail-templates\u002Fcomponents","3.modules\u002F5.platform\u002F3.email-templates\u002F2.components",{"title":175,"path":417,"stem":418},"\u002Fmodules\u002Fplatform\u002Femail-templates\u002Fserver","3.modules\u002F5.platform\u002F3.email-templates\u002F3.server",{"title":420,"path":421,"stem":422},"Module emails","\u002Fmodules\u002Fplatform\u002Femail-templates\u002Fmodule-emails","3.modules\u002F5.platform\u002F3.email-templates\u002F4.module-emails",{"title":424,"path":425,"stem":426,"children":427},"Base Layer","\u002Fmodules\u002Fplatform\u002Fbase-layer","3.modules\u002F5.platform\u002F4.base-layer\u002Findex",[428,429,433,437],{"title":173,"path":425,"stem":426},{"title":430,"path":431,"stem":432},"Content collections","\u002Fmodules\u002Fplatform\u002Fbase-layer\u002Fcontent-collections","3.modules\u002F5.platform\u002F4.base-layer\u002F2.content-collections",{"title":434,"path":435,"stem":436},"Layouts and routing","\u002Fmodules\u002Fplatform\u002Fbase-layer\u002Flayouts-and-routing","3.modules\u002F5.platform\u002F4.base-layer\u002F3.layouts-and-routing",{"title":438,"path":439,"stem":440},"Composables and utils","\u002Fmodules\u002Fplatform\u002Fbase-layer\u002Fcomposables-and-utils","3.modules\u002F5.platform\u002F4.base-layer\u002F4.composables-and-utils",{"title":442,"icon":443,"path":444,"stem":445,"children":446,"page":49},"Examples","i-lucide-code-xml","\u002Fexamples","4.examples",[447,466,476],{"title":448,"icon":49,"path":449,"stem":450,"children":451,"page":49},"Starters","\u002Fexamples\u002Fstarters","4.examples\u002F1.starters",[452,456,461],{"title":453,"path":454,"stem":455,"icon":6},"Workspace starter","\u002Fexamples\u002Fstarters\u002Fworkspace","4.examples\u002F1.starters\u002F1.workspace",{"title":457,"path":458,"stem":459,"icon":460},"Mobile starter","\u002Fexamples\u002Fstarters\u002Fmobile","4.examples\u002F1.starters\u002F2.mobile","i-lucide-smartphone",{"title":462,"path":463,"stem":464,"icon":465},"Standalone mobile starter","\u002Fexamples\u002Fstarters\u002Fmobile-standalone","4.examples\u002F1.starters\u002F3.mobile-standalone","i-lucide-tablet-smartphone",{"title":467,"icon":49,"path":468,"stem":469,"children":470,"page":49},"Apps","\u002Fexamples\u002Fapps","4.examples\u002F2.apps",[471],{"title":472,"path":473,"stem":474,"icon":475},"Frigear website app","\u002Fexamples\u002Fapps\u002Ffrigear-nu-website","4.examples\u002F2.apps\u002F1.frigear-nu-website","i-lucide-layout-dashboard",{"title":477,"icon":49,"path":478,"stem":479,"children":480,"page":49},"Tasks","\u002Fexamples\u002Ftasks","4.examples\u002F3.tasks",[481,485,489,494,499],{"title":482,"path":483,"stem":484,"icon":70},"Protect a route","\u002Fexamples\u002Ftasks\u002Fprotect-a-route","4.examples\u002F3.tasks\u002F1.protect-a-route",{"title":486,"path":487,"stem":488,"icon":475},"Add an admin page","\u002Fexamples\u002Ftasks\u002Fadd-an-admin-page","4.examples\u002F3.tasks\u002F2.add-an-admin-page",{"title":490,"path":491,"stem":492,"icon":493},"Sell event tickets","\u002Fexamples\u002Ftasks\u002Fsell-event-tickets","4.examples\u002F3.tasks\u002F3.sell-event-tickets","i-lucide-ticket",{"title":495,"path":496,"stem":497,"icon":498},"Build a form","\u002Fexamples\u002Ftasks\u002Fbuild-a-form","4.examples\u002F3.tasks\u002F4.build-a-form","i-lucide-clipboard-list",{"title":500,"path":501,"stem":502,"icon":503},"Send an email","\u002Fexamples\u002Ftasks\u002Fsend-an-email","4.examples\u002F3.tasks\u002F5.send-an-email","i-lucide-mail",{"title":505,"icon":506,"path":507,"stem":508,"children":509,"page":49},"Contribute","i-lucide-git-pull-request","\u002Fcontribute","5.contribute",[510,513,518,544,549,552,556,571],{"title":173,"path":511,"stem":512,"icon":506},"\u002Fcontribute\u002Foverview","5.contribute\u002F1.overview",{"title":514,"path":515,"stem":516,"icon":517},"Local development","\u002Fcontribute\u002Flocal-development","5.contribute\u002F2.local-development","i-lucide-terminal",{"title":519,"icon":49,"path":520,"stem":521,"children":522,"page":49},"Writing a module","\u002Fcontribute\u002Fwriting-a-module","5.contribute\u002F3.writing-a-module",[523,527,532,536,541],{"title":524,"path":525,"stem":526,"icon":39},"Scaffold a module","\u002Fcontribute\u002Fwriting-a-module\u002Fscaffold","5.contribute\u002F3.writing-a-module\u002F1.scaffold",{"title":528,"path":529,"stem":530,"icon":531},"Setup checklist","\u002Fcontribute\u002Fwriting-a-module\u002Fsetup-checklist","5.contribute\u002F3.writing-a-module\u002F2.setup-checklist","i-lucide-list-checks",{"title":533,"path":534,"stem":535,"icon":44},"Database tables","\u002Fcontribute\u002Fwriting-a-module\u002Fdatabase-tables","5.contribute\u002F3.writing-a-module\u002F3.database-tables",{"title":537,"path":538,"stem":539,"icon":540},"Testing","\u002Fcontribute\u002Fwriting-a-module\u002Ftesting","5.contribute\u002F3.writing-a-module\u002F4.testing","i-lucide-flask-conical",{"title":67,"path":542,"stem":543,"icon":70},"\u002Fcontribute\u002Fwriting-a-module\u002Faccess-control","5.contribute\u002F3.writing-a-module\u002F5.access-control",{"title":545,"path":546,"stem":547,"icon":548},"Publishing","\u002Fcontribute\u002Fpublishing","5.contribute\u002F4.publishing","i-lucide-package-check",{"title":448,"path":550,"stem":551,"icon":6},"\u002Fcontribute\u002Fstarters","5.contribute\u002F5.starters",{"title":553,"path":554,"stem":555,"icon":52},"Documentation","\u002Fcontribute\u002Fdocumentation","5.contribute\u002F6.documentation",{"title":557,"icon":49,"path":558,"stem":559,"children":560,"page":49},"Tooling","\u002Fcontribute\u002Ftooling","5.contribute\u002F7.tooling",[561,566],{"title":562,"path":563,"stem":564,"icon":565},"CLI","\u002Fcontribute\u002Ftooling\u002Fcli","5.contribute\u002F7.tooling\u002F1.cli","i-lucide-square-terminal",{"title":567,"path":568,"stem":569,"icon":570},"ESLint config","\u002Fcontribute\u002Ftooling\u002Feslint-config","5.contribute\u002F7.tooling\u002F2.eslint-config","i-lucide-spell-check",{"title":572,"icon":49,"path":573,"stem":574,"children":575},"Decisions","\u002Fcontribute\u002Fdecisions","5.contribute\u002F8.decisions\u002Findex",[576,578,583],{"title":572,"path":573,"stem":574,"icon":577},"i-lucide-scale",{"title":579,"path":580,"stem":581,"icon":582},"Session lifetimes per OAuth client","\u002Fcontribute\u002Fdecisions\u002Foauth-token-lifetimes","5.contribute\u002F8.decisions\u002F1.oauth-token-lifetimes","i-lucide-timer",{"title":584,"path":585,"stem":586,"icon":70},"One permission model","\u002Fcontribute\u002Fdecisions\u002Fpermission-model","5.contribute\u002F8.decisions\u002F2.permission-model",{"id":588,"title":41,"body":589,"description":1186,"extension":1187,"links":1188,"meta":1189,"navigation":1190,"path":42,"seo":1191,"stem":43,"__hash__":1192},"docs\u002F1.get-started\u002F7.database.md",{"type":590,"value":591,"toc":1178},"minimark",[592,599,612,629,634,641,645,659,670,811,825,833,837,840,843,854,884,894,898,902,909,1016,1019,1028,1032,1039,1045,1052,1063,1082,1138,1143,1157,1161,1174],[593,594,595],"p",{},[596,597,598],"strong",{},"What you'll have afterwards:",[600,601,602,606,609],"ul",{},[603,604,605],"li",{},"You know when to generate a migration and which files to commit.",[603,607,608],{},"You can add a column of your own to a table a module owns.",[603,610,611],{},"You know what changes when you move from SQLite to PostgreSQL.",[593,613,614,615,619,620,623,624,628],{},"Modules bring their own tables, such as ",[616,617,618],"code",{},"users"," or ",[616,621,622],{},"forms",". Your app's database only gets them through a\n",[625,626,627],"a",{"href":87},"migration"," you generate and commit. This page explains that step and the database behind it.",[630,631,633],"h2",{"id":632},"prerequisites","Prerequisites",[593,635,636,637,640],{},"A project created in ",[625,638,16],{"href":639},"\u002Fget-started\u002Finstallation#_1-create-the-project",".",[630,642,644],{"id":643},"where-the-database-lives","Where the database lives",[593,646,647,648,654,655,658],{},"The starter uses the database of ",[625,649,653],{"href":650,"rel":651},"https:\u002F\u002Fhub.nuxt.com\u002Fdocs\u002Fdatabase",[652],"nofollow","NuxtHub",", the module that gives the host app its\ndatabase and blob storage. Modules define their tables with ",[625,656,657],{"href":87},"Drizzle",", a TypeScript\nobject-relational mapper (ORM).",[593,660,661,662,665,666,669],{},"Locally the database is a SQLite file, ",[616,663,664],{},"apps\u002Fweb\u002F.data\u002Fdb\u002Fsqlite.db",", opened through the libsql driver. It is set in\n",[616,667,668],{},"nuxt.config.ts",":",[671,672,678],"pre",{"className":673,"code":674,"filename":675,"language":676,"meta":677,"style":677},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineNuxtConfig({\n  hub: {\n    db: {\n      dialect: 'sqlite',\n      driver: 'libsql',\n      connection: { url: 'file:.\u002F.data\u002Fdb\u002Fsqlite.db' },\n    },\n  },\n})\n","apps\u002Fweb\u002Fnuxt.config.ts","ts","",[616,679,680,704,716,726,747,764,790,796,802],{"__ignoreMap":677},[681,682,685,689,692,696,700],"span",{"class":683,"line":684},"line",1,[681,686,688],{"class":687},"s7zQu","export",[681,690,691],{"class":687}," default",[681,693,695],{"class":694},"s2Zo4"," defineNuxtConfig",[681,697,699],{"class":698},"sTEyZ","(",[681,701,703],{"class":702},"sMK4o","{\n",[681,705,707,711,713],{"class":683,"line":706},2,[681,708,710],{"class":709},"swJcz","  hub",[681,712,669],{"class":702},[681,714,715],{"class":702}," {\n",[681,717,719,722,724],{"class":683,"line":718},3,[681,720,721],{"class":709},"    db",[681,723,669],{"class":702},[681,725,715],{"class":702},[681,727,729,732,734,737,741,744],{"class":683,"line":728},4,[681,730,731],{"class":709},"      dialect",[681,733,669],{"class":702},[681,735,736],{"class":702}," '",[681,738,740],{"class":739},"sfazB","sqlite",[681,742,743],{"class":702},"'",[681,745,746],{"class":702},",\n",[681,748,750,753,755,757,760,762],{"class":683,"line":749},5,[681,751,752],{"class":709},"      driver",[681,754,669],{"class":702},[681,756,736],{"class":702},[681,758,759],{"class":739},"libsql",[681,761,743],{"class":702},[681,763,746],{"class":702},[681,765,767,770,772,775,778,780,782,785,787],{"class":683,"line":766},6,[681,768,769],{"class":709},"      connection",[681,771,669],{"class":702},[681,773,774],{"class":702}," {",[681,776,777],{"class":709}," url",[681,779,669],{"class":702},[681,781,736],{"class":702},[681,783,784],{"class":739},"file:.\u002F.data\u002Fdb\u002Fsqlite.db",[681,786,743],{"class":702},[681,788,789],{"class":702}," },\n",[681,791,793],{"class":683,"line":792},7,[681,794,795],{"class":702},"    },\n",[681,797,799],{"class":683,"line":798},8,[681,800,801],{"class":702},"  },\n",[681,803,805,808],{"class":683,"line":804},9,[681,806,807],{"class":702},"}",[681,809,810],{"class":698},")\n",[593,812,813,814,817,818,821,822,640],{},"NuxtHub applies the committed migrations in ",[616,815,816],{},"apps\u002Fweb\u002Fserver\u002Fdb\u002Fmigrations"," when you run ",[616,819,820],{},"nuxt dev"," and ",[616,823,824],{},"nuxt build",[826,827,828,829,832],"caution",{},"To start over locally, delete ",[616,830,831],{},"apps\u002Fweb\u002F.data",". This deletes every local user and record, and cannot be undone.",[630,834,836],{"id":835},"migrations","Migrations",[593,838,839],{},"A module registers its tables, but that only changes the generated Drizzle schema. The database itself does not change.",[593,841,842],{},"Generate and commit a migration whenever a module adds or changes columns:",[600,844,845,848,851],{},[603,846,847],{},"after you add a module,",[603,849,850],{},"after you upgrade one,",[603,852,853],{},"after you extend a table yourself.",[671,855,859],{"className":856,"code":857,"language":858,"meta":677,"style":677},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm db:generate   # generate migration files from schema changes\npnpm db:migrate    # apply migrations to the development database\n","bash",[616,860,861,874],{"__ignoreMap":677},[681,862,863,867,870],{"class":683,"line":684},[681,864,866],{"class":865},"sBMFI","pnpm",[681,868,869],{"class":739}," db:generate",[681,871,873],{"class":872},"sHwdD","   # generate migration files from schema changes\n",[681,875,876,878,881],{"class":683,"line":706},[681,877,866],{"class":865},[681,879,880],{"class":739}," db:migrate",[681,882,883],{"class":872},"    # apply migrations to the development database\n",[593,885,886,889,890,893],{},[616,887,888],{},"pnpm db:generate"," prints ",[616,891,892],{},"No schema changes, nothing to migrate"," when the database is already up to date.",[895,896,897],"warning",{},"Commit the generated SQL, the Drizzle snapshot and the journal together. They are versioned schema history, not build\nartifacts.",[630,899,901],{"id":900},"add-columns-to-a-modules-table","Add columns to a module's table",[593,903,904,905,908],{},"A host app adds columns to a table it does not own from its own ",[616,906,907],{},"server\u002Fdb\u002Fextend.\u003Cdialect>.ts",". Export one table or\ncolumns object per table, under the table's name:",[671,910,913],{"className":673,"code":911,"filename":912,"language":676,"meta":677,"style":677},"import { text } from 'drizzle-orm\u002Fsqlite-core'\n\nexport const users = { locale: text().default('da') }\nexport const posts = { summary: text() }\n","apps\u002Fweb\u002Fserver\u002Fdb\u002Fextend.sqlite.ts",[616,914,915,939,945,991],{"__ignoreMap":677},[681,916,917,920,922,925,928,931,933,936],{"class":683,"line":684},[681,918,919],{"class":687},"import",[681,921,774],{"class":702},[681,923,924],{"class":698}," text",[681,926,927],{"class":702}," }",[681,929,930],{"class":687}," from",[681,932,736],{"class":702},[681,934,935],{"class":739},"drizzle-orm\u002Fsqlite-core",[681,937,938],{"class":702},"'\n",[681,940,941],{"class":683,"line":706},[681,942,944],{"emptyLinePlaceholder":943},true,"\n",[681,946,947,949,953,956,959,961,964,966,968,971,973,976,978,980,983,985,988],{"class":683,"line":718},[681,948,688],{"class":687},[681,950,952],{"class":951},"spNyl"," const",[681,954,955],{"class":698}," users ",[681,957,958],{"class":702},"=",[681,960,774],{"class":702},[681,962,963],{"class":709}," locale",[681,965,669],{"class":702},[681,967,924],{"class":694},[681,969,970],{"class":698},"()",[681,972,640],{"class":702},[681,974,975],{"class":694},"default",[681,977,699],{"class":698},[681,979,743],{"class":702},[681,981,982],{"class":739},"da",[681,984,743],{"class":702},[681,986,987],{"class":698},") ",[681,989,990],{"class":702},"}\n",[681,992,993,995,997,1000,1002,1004,1007,1009,1011,1014],{"class":683,"line":728},[681,994,688],{"class":687},[681,996,952],{"class":951},[681,998,999],{"class":698}," posts ",[681,1001,958],{"class":702},[681,1003,774],{"class":702},[681,1005,1006],{"class":709}," summary",[681,1008,669],{"class":702},[681,1010,924],{"class":694},[681,1012,1013],{"class":698},"() ",[681,1015,990],{"class":702},[593,1017,1018],{},"Only the export that matches the table being built is used. The file is merged after every module.",[593,1020,1021,1022,1024,1025,1027],{},"Then run ",[616,1023,888],{}," and commit the migration. ",[625,1026,77],{"href":78},"\nexplains the details.",[630,1029,1031],{"id":1030},"sqlite-and-postgresql","SQLite and PostgreSQL",[593,1033,1034,1035,1038],{},"The database type a schema is written for is its ",[625,1036,1037],{"href":87},"dialect",": SQLite or PostgreSQL. Every\nmodule ships its schema for both. So you can run SQLite or libSQL\u002FTurso locally, and Cloudflare D1, libSQL\u002FTurso or\nPostgreSQL in production.",[593,1040,1041,1042,640],{},"The committed migrations are per dialect. The starter keeps them in ",[616,1043,1044],{},"server\u002Fdb\u002Fmigrations\u002Fsqlite",[895,1046,1047,1048,1051],{},"If you change ",[616,1049,1050],{},"hub.db.dialect",", generate and commit migrations for the new dialect before you deploy.",[593,1053,1054,1055,1058,1059,1062],{},"If you extend a table, keep a ",[616,1056,1057],{},".postgresql.ts"," twin next to each ",[616,1060,1061],{},".sqlite.ts"," file:",[600,1064,1065,1068,1071],{},[603,1066,1067],{},"It has the same table, column and index names.",[603,1069,1070],{},"You change both files in the same commit.",[603,1072,1073,1074,1077,1078,1081],{},"It uses ",[616,1075,1076],{},"pgTable"," from ",[616,1079,1080],{},"drizzle-orm\u002Fpg-core"," and the matching column types.",[1083,1084,1085,1098],"table",{},[1086,1087,1088],"thead",{},[1089,1090,1091,1095],"tr",{},[1092,1093,1094],"th",{},"SQLite",[1092,1096,1097],{},"PostgreSQL",[1099,1100,1101,1114,1126],"tbody",{},[1089,1102,1103,1109],{},[1104,1105,1106],"td",{},[616,1107,1108],{},"integer().primaryKey({ autoIncrement: true })",[1104,1110,1111],{},[616,1112,1113],{},"serial().primaryKey()",[1089,1115,1116,1121],{},[1104,1117,1118],{},[616,1119,1120],{},"integer({ mode: 'timestamp' })",[1104,1122,1123],{},[616,1124,1125],{},"timestamp({ withTimezone: true })",[1089,1127,1128,1133],{},[1104,1129,1130],{},[616,1131,1132],{},"text({ mode: 'json' })",[1104,1134,1135],{},[616,1136,1137],{},"jsonb()",[593,1139,1140,1141,640],{},"The full table is in ",[625,1142,77],{"href":78},[593,1144,1145,1146,1149,1150,1149,1153,1156],{},"Write runtime queries with Drizzle so they work on both dialects. Avoid ",[616,1147,1148],{},"db.run",", ",[616,1151,1152],{},"db.batch",[616,1154,1155],{},"PRAGMA"," and other\nSQLite-only SQL.",[630,1158,1160],{"id":1159},"next-steps","Next steps",[600,1162,1163,1168],{},[603,1164,1165,1167],{},[625,1166,46],{"href":47}," – take the app and its database to production.",[603,1169,1170,1173],{},[625,1171,1172],{"href":400},"Module Kit database"," – register tables of your own when you write a module.",[1175,1176,1177],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":677,"searchDepth":706,"depth":706,"links":1179},[1180,1181,1182,1183,1184,1185],{"id":632,"depth":706,"text":633},{"id":643,"depth":706,"text":644},{"id":835,"depth":706,"text":836},{"id":900,"depth":706,"text":901},{"id":1030,"depth":706,"text":1031},{"id":1159,"depth":706,"text":1160},"How the app's database works with NuxtHub, when to generate migrations, and how to add columns to a module's tables.","md",null,{},{"icon":44},{"title":41,"description":1186},"LZG-EsfcJoRA3PdtBGPSLytEijG0ByaQx5ct4nWaN_c",[1194,1196],{"title":36,"path":37,"stem":38,"description":1195,"icon":39,"children":-1},"Find the module you need and add it to your app, with its options, policies and migration.",{"title":46,"path":47,"stem":48,"description":1197,"icon":6,"children":-1},"Checklist for taking a Frigear app to production, and where to go next.",1794503145112]