[{"data":1,"prerenderedAt":1080},["ShallowReactive",2],{"docs-navigation:en":3,"content-page:docs:sRolNpkzOawr8HJzVK7lwKltmABzOuAr3R2D_lwP4hg":595,"content-page-surround:docs:sRolNpkzOawr8HJzVK7lwKltmABzOuAr3R2D_lwP4hg":1069,"i-lucide:terminal":1074,"i-lucide:clipboard":1078},[4,55,123,191,450,509,554,590],{"title":5,"page":6,"canonicalKey":7,"locale":8,"id":9,"draft":6,"icon":10,"sidebar":11,"children":12},"Learn",false,"1","en","content:docs:1.overview:.navigation.yml","i-lucide-book-open","section",[13,20,27,34,41,48],{"title":14,"id":15,"canonicalKey":16,"locale":8,"draft":6,"navigation":17,"icon":18,"path":19},"Better Convex Nuxt","content:docs:1.overview:1.introduction.md","1\u002F1",{"icon":18},"i-lucide-orbit","\u002Fdocs\u002Foverview\u002Fintroduction",{"title":21,"id":22,"canonicalKey":23,"locale":8,"draft":6,"navigation":24,"icon":25,"path":26},"Why Better Convex Nuxt","content:docs:1.overview:2.why-better-convex-nuxt.md","1\u002F2",{"icon":25},"i-lucide-badge-check","\u002Fdocs\u002Foverview\u002Fwhy-better-convex-nuxt",{"title":28,"id":29,"canonicalKey":30,"locale":8,"draft":6,"navigation":31,"icon":32,"path":33},"Who It Is For","content:docs:1.overview:3.who-it-is-for.md","1\u002F3",{"icon":32},"i-lucide-users","\u002Fdocs\u002Foverview\u002Fwho-it-is-for",{"title":35,"id":36,"canonicalKey":37,"locale":8,"draft":6,"navigation":38,"icon":39,"path":40},"Use Cases","content:docs:1.overview:4.use-cases.md","1\u002F4",{"icon":39},"i-lucide-layout-dashboard","\u002Fdocs\u002Foverview\u002Fuse-cases",{"title":42,"id":43,"canonicalKey":44,"locale":8,"draft":6,"navigation":45,"icon":46,"path":47},"Compare Nuxt Integrations","content:docs:1.overview:5.comparison.md","1\u002F5",{"icon":46},"i-lucide-scale","\u002Fdocs\u002Foverview\u002Fcomparison",{"title":49,"id":50,"canonicalKey":51,"locale":8,"draft":6,"navigation":52,"icon":53,"path":54},"Limitations and Trade-offs","content:docs:1.overview:6.limitations.md","1\u002F6",{"icon":53},"i-lucide-triangle-alert","\u002Fdocs\u002Foverview\u002Flimitations",{"title":56,"page":6,"canonicalKey":57,"locale":8,"id":58,"draft":6,"icon":59,"children":60},"Understand","2","content:docs:2.understand:.navigation.yml","i-lucide-brain",[61,67,74,81,88,95,102,109,116],{"title":62,"id":63,"canonicalKey":64,"locale":8,"draft":6,"navigation":65,"icon":59,"path":66},"Mental Model","content:docs:2.understand:1.mental-model.md","2\u002F1",{"icon":59},"\u002Fdocs\u002Funderstand\u002Fmental-model",{"title":68,"id":69,"canonicalKey":70,"locale":8,"draft":6,"navigation":71,"icon":72,"path":73},"Request Lifecycle","content:docs:2.understand:2.request-lifecycle.md","2\u002F2",{"icon":72},"i-lucide-route","\u002Fdocs\u002Funderstand\u002Frequest-lifecycle",{"title":75,"id":76,"canonicalKey":77,"locale":8,"draft":6,"navigation":78,"icon":79,"path":80},"SSR, Hydration, and Real-Time","content:docs:2.understand:3.ssr-hydration-realtime.md","2\u002F3",{"icon":79},"i-lucide-refresh-cw","\u002Fdocs\u002Funderstand\u002Fssr-hydration-realtime",{"title":82,"id":83,"canonicalKey":84,"locale":8,"draft":6,"navigation":85,"icon":86,"path":87},"Query Ownership and Caching","content:docs:2.understand:4.query-ownership-and-caching.md","2\u002F4",{"icon":86},"i-lucide-database","\u002Fdocs\u002Funderstand\u002Fquery-ownership-and-caching",{"title":89,"id":90,"canonicalKey":91,"locale":8,"draft":6,"navigation":92,"icon":93,"path":94},"Authentication and Identity","content:docs:2.understand:5.authentication-and-identity.md","2\u002F5",{"icon":93},"i-lucide-fingerprint","\u002Fdocs\u002Funderstand\u002Fauthentication-and-identity",{"title":96,"id":97,"canonicalKey":98,"locale":8,"draft":6,"navigation":99,"icon":100,"path":101},"Server and Client Boundaries","content:docs:2.understand:6.server-and-client-boundaries.md","2\u002F6",{"icon":100},"i-lucide-panels-top-left","\u002Fdocs\u002Funderstand\u002Fserver-and-client-boundaries",{"title":103,"id":104,"canonicalKey":105,"locale":8,"draft":6,"navigation":106,"icon":107,"path":108},"Errors and Failures","content:docs:2.understand:7.errors-and-failures.md","2\u002F7",{"icon":107},"i-lucide-circle-x","\u002Fdocs\u002Funderstand\u002Ferrors-and-failures",{"title":110,"id":111,"canonicalKey":112,"locale":8,"draft":6,"navigation":113,"icon":114,"path":115},"Design Decisions","content:docs:2.understand:8.design-decisions.md","2\u002F8",{"icon":114},"i-lucide-git-branch","\u002Fdocs\u002Funderstand\u002Fdesign-decisions",{"title":117,"id":118,"canonicalKey":119,"locale":8,"draft":6,"navigation":120,"icon":121,"path":122},"Glossary","content:docs:2.understand:9.glossary.md","2\u002F9",{"icon":121},"i-lucide-book-a","\u002Fdocs\u002Funderstand\u002Fglossary",{"title":124,"page":6,"canonicalKey":125,"locale":8,"id":126,"draft":6,"icon":127,"children":128},"Get Started","3","content:docs:3.get-started:.navigation.yml","i-lucide-rocket",[129,136,143,150,157,164,171,178,185],{"title":130,"id":131,"canonicalKey":132,"locale":8,"draft":6,"navigation":133,"icon":134,"path":135},"Choose Your Path","content:docs:3.get-started:1.choose-your-path.md","3\u002F1",{"icon":134},"i-lucide-signpost","\u002Fdocs\u002Fget-started\u002Fchoose-your-path",{"title":137,"id":138,"canonicalKey":139,"locale":8,"draft":6,"navigation":140,"icon":141,"path":142},"Installation","content:docs:3.get-started:2.installation.md","3\u002F2",{"icon":141},"i-lucide-download","\u002Fdocs\u002Fget-started\u002Finstallation",{"title":144,"id":145,"canonicalKey":146,"locale":8,"draft":6,"navigation":147,"icon":148,"path":149},"First Real-Time Page","content:docs:3.get-started:3.first-realtime-page.md","3\u002F3",{"icon":148},"i-lucide-radio","\u002Fdocs\u002Fget-started\u002Ffirst-realtime-page",{"title":151,"id":152,"canonicalKey":153,"locale":8,"draft":6,"navigation":154,"icon":155,"path":156},"Add a Mutation","content:docs:3.get-started:4.add-a-mutation.md","3\u002F4",{"icon":155},"i-lucide-square-pen","\u002Fdocs\u002Fget-started\u002Fadd-a-mutation",{"title":158,"id":159,"canonicalKey":160,"locale":8,"draft":6,"navigation":161,"icon":162,"path":163},"Add Authentication","content:docs:3.get-started:5.add-authentication.md","3\u002F5",{"icon":162},"i-lucide-log-in","\u002Fdocs\u002Fget-started\u002Fadd-authentication",{"title":165,"id":166,"canonicalKey":167,"locale":8,"draft":6,"navigation":168,"icon":169,"path":170},"Protect Data","content:docs:3.get-started:6.protect-data.md","3\u002F6",{"icon":169},"i-lucide-shield-check","\u002Fdocs\u002Fget-started\u002Fprotect-data",{"title":172,"id":173,"canonicalKey":174,"locale":8,"draft":6,"navigation":175,"icon":176,"path":177},"Project Structure","content:docs:3.get-started:7.project-structure.md","3\u002F7",{"icon":176},"i-lucide-folder-tree","\u002Fdocs\u002Fget-started\u002Fproject-structure",{"title":179,"id":180,"canonicalKey":181,"locale":8,"draft":6,"navigation":182,"icon":183,"path":184},"Next Steps","content:docs:3.get-started:8.next-steps.md","3\u002F8",{"icon":183},"i-lucide-arrow-right","\u002Fdocs\u002Fget-started\u002Fnext-steps",{"title":186,"id":187,"canonicalKey":188,"locale":8,"draft":6,"navigation":189,"icon":100,"path":190},"Plain Vue and Vite","content:docs:3.get-started:9.plain-vue.md","3\u002F9",{"icon":100},"\u002Fdocs\u002Fget-started\u002Fplain-vue",{"title":192,"page":6,"canonicalKey":193,"locale":8,"id":194,"draft":6,"icon":195,"sidebar":11,"children":196},"Build","4","content:docs:4.build:.navigation.yml","i-lucide-blocks",[197,234,265,336,368,393,432],{"title":198,"page":6,"canonicalKey":199,"locale":8,"children":200},"Queries","4\u002F1",[201,206,213,220,227],{"title":198,"id":202,"canonicalKey":203,"locale":8,"draft":6,"navigation":204,"icon":86,"path":205},"content:docs:4.build:1.queries:1.queries.md","4\u002F1\u002F1",{"icon":86},"\u002Fdocs\u002Fbuild\u002Fqueries\u002Fqueries",{"title":207,"id":208,"canonicalKey":209,"locale":8,"draft":6,"navigation":210,"icon":211,"path":212},"Reactive Arguments","content:docs:4.build:1.queries:2.reactive-arguments.md","4\u002F1\u002F2",{"icon":211},"i-lucide-sliders-horizontal","\u002Fdocs\u002Fbuild\u002Fqueries\u002Freactive-arguments",{"title":214,"id":215,"canonicalKey":216,"locale":8,"draft":6,"navigation":217,"icon":218,"path":219},"Loading and Stale Data","content:docs:4.build:1.queries:3.loading-and-stale-data.md","4\u002F1\u002F3",{"icon":218},"i-lucide-loader-circle","\u002Fdocs\u002Fbuild\u002Fqueries\u002Floading-and-stale-data",{"title":221,"id":222,"canonicalKey":223,"locale":8,"draft":6,"navigation":224,"icon":225,"path":226},"Query Execution Options","content:docs:4.build:1.queries:4.ssr-options.md","4\u002F1\u002F4",{"icon":225},"i-lucide-server-cog","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fssr-options",{"title":228,"id":229,"canonicalKey":230,"locale":8,"draft":6,"navigation":231,"icon":232,"path":233},"Pagination","content:docs:4.build:1.queries:6.pagination.md","4\u002F1\u002F6",{"icon":232},"i-lucide-list-plus","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fpagination",{"title":235,"page":6,"canonicalKey":236,"locale":8,"children":237},"Write Data","4\u002F2",[238,244,251,258],{"title":239,"id":240,"canonicalKey":241,"locale":8,"draft":6,"navigation":242,"icon":155,"path":243},"Mutations","content:docs:4.build:2.write-data:1.mutations.md","4\u002F2\u002F1",{"icon":155},"\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmutations",{"title":245,"id":246,"canonicalKey":247,"locale":8,"draft":6,"navigation":248,"icon":249,"path":250},"Actions","content:docs:4.build:2.write-data:2.actions.md","4\u002F2\u002F2",{"icon":249},"i-lucide-zap","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Factions",{"title":252,"id":253,"canonicalKey":254,"locale":8,"draft":6,"navigation":255,"icon":256,"path":257},"Optimistic Updates","content:docs:4.build:2.write-data:3.optimistic-updates.md","4\u002F2\u002F3",{"icon":256},"i-lucide-gauge","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Foptimistic-updates",{"title":259,"id":260,"canonicalKey":261,"locale":8,"draft":6,"navigation":262,"icon":263,"path":264},"Concurrent Operations","content:docs:4.build:2.write-data:4.concurrent-operations.md","4\u002F2\u002F4",{"icon":263},"i-lucide-git-fork","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fconcurrent-operations",{"title":266,"page":6,"canonicalKey":267,"locale":8,"children":268},"Authentication","4\u002F3",[269,275,282,289,295,301,308,315,322,329],{"title":266,"id":270,"canonicalKey":271,"locale":8,"draft":6,"navigation":272,"icon":273,"path":274},"content:docs:4.build:3.authentication:1.overview.md","4\u002F3\u002F1",{"icon":273},"i-lucide-shield","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Foverview",{"title":276,"id":277,"canonicalKey":278,"locale":8,"draft":6,"navigation":279,"icon":280,"path":281},"Better Auth Setup","content:docs:4.build:3.authentication:2.better-auth-setup.md","4\u002F3\u002F2",{"icon":280},"i-lucide-settings-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-setup",{"title":283,"id":284,"canonicalKey":285,"locale":8,"draft":6,"navigation":286,"icon":287,"path":288},"Auth State and User Data","content:docs:4.build:3.authentication:3.auth-state-and-user.md","4\u002F3\u002F3",{"icon":287},"i-lucide-user-round","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fauth-state-and-user",{"title":290,"id":291,"canonicalKey":292,"locale":8,"draft":6,"navigation":293,"icon":162,"path":294},"Sign In and Sign Out","content:docs:4.build:3.authentication:4.sign-in-and-sign-out.md","4\u002F3\u002F4",{"icon":162},"\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsign-in-and-sign-out",{"title":296,"id":297,"canonicalKey":298,"locale":8,"draft":6,"navigation":299,"icon":72,"path":300},"Route Protection","content:docs:4.build:3.authentication:5.route-protection.md","4\u002F3\u002F5",{"icon":72},"\u002Fdocs\u002Fbuild\u002Fauthentication\u002Froute-protection",{"title":302,"id":303,"canonicalKey":304,"locale":8,"draft":6,"navigation":305,"icon":306,"path":307},"Backend Authorization","content:docs:4.build:3.authentication:6.backend-authorization.md","4\u002F3\u002F6",{"icon":306},"i-lucide-lock-keyhole","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbackend-authorization",{"title":309,"id":310,"canonicalKey":311,"locale":8,"draft":6,"navigation":312,"icon":313,"path":314},"Better Auth Plugins","content:docs:4.build:3.authentication:7.better-auth-plugins.md","4\u002F3\u002F7",{"icon":313},"i-lucide-plug","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugins",{"title":316,"id":317,"canonicalKey":318,"locale":8,"draft":6,"navigation":319,"icon":320,"path":321},"Custom User Fields","content:docs:4.build:3.authentication:8.custom-user-fields.md","4\u002F3\u002F8",{"icon":320},"i-lucide-user-cog","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcustom-user-fields",{"title":323,"id":324,"canonicalKey":325,"locale":8,"draft":6,"navigation":326,"icon":327,"path":328},"User Synchronization","content:docs:4.build:3.authentication:9.user-synchronization.md","4\u002F3\u002F9",{"icon":327},"i-lucide-refresh-ccw","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fuser-synchronization",{"title":330,"id":331,"canonicalKey":332,"locale":8,"draft":6,"navigation":333,"icon":334,"path":335},"Delegated OAuth and MCP","content:docs:4.build:3.authentication:10.delegated-oauth-and-mcp.md","4\u002F3\u002F10",{"icon":334},"i-lucide-bot","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fdelegated-oauth-and-mcp",{"title":337,"page":6,"canonicalKey":338,"locale":8,"children":339},"Server","4\u002F4",[340,347,354,361],{"title":341,"id":342,"canonicalKey":343,"locale":8,"draft":6,"navigation":344,"icon":345,"path":346},"serverConvex","content:docs:4.build:4.server:1.server-convex.md","4\u002F4\u002F1",{"icon":345},"i-lucide-server","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-convex",{"title":348,"id":349,"canonicalKey":350,"locale":8,"draft":6,"navigation":351,"icon":352,"path":353},"Server Routes","content:docs:4.build:4.server:2.server-routes.md","4\u002F4\u002F2",{"icon":352},"i-lucide-waypoints","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-routes",{"title":355,"id":356,"canonicalKey":357,"locale":8,"draft":6,"navigation":358,"icon":359,"path":360},"Webhooks and Jobs","content:docs:4.build:4.server:3.webhooks-and-jobs.md","4\u002F4\u002F3",{"icon":359},"i-lucide-webhook","\u002Fdocs\u002Fbuild\u002Fserver\u002Fwebhooks-and-jobs",{"title":362,"id":363,"canonicalKey":364,"locale":8,"draft":6,"navigation":365,"icon":366,"path":367},"Credentials and Server Security","content:docs:4.build:4.server:4.credentials-and-security.md","4\u002F4\u002F4",{"icon":366},"i-lucide-key-round","\u002Fdocs\u002Fbuild\u002Fserver\u002Fcredentials-and-security",{"title":369,"page":6,"canonicalKey":370,"locale":8,"children":371},"Files","4\u002F5",[372,379,386],{"title":373,"id":374,"canonicalKey":375,"locale":8,"draft":6,"navigation":376,"icon":377,"path":378},"Upload Files","content:docs:4.build:5.files:1.upload-files.md","4\u002F5\u002F1",{"icon":377},"i-lucide-upload","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fupload-files",{"title":380,"id":381,"canonicalKey":382,"locale":8,"draft":6,"navigation":383,"icon":384,"path":385},"Storage URLs","content:docs:4.build:5.files:3.storage-urls.md","4\u002F5\u002F3",{"icon":384},"i-lucide-link","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fstorage-urls",{"title":387,"id":388,"canonicalKey":389,"locale":8,"draft":6,"navigation":390,"icon":391,"path":392},"File Validation and Deletion","content:docs:4.build:5.files:4.validation-and-deletion.md","4\u002F5\u002F4",{"icon":391},"i-lucide-file-x","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fvalidation-and-deletion",{"title":394,"page":6,"canonicalKey":395,"locale":8,"children":396},"Application Behavior","4\u002F6",[397,404,411,418,425],{"title":398,"id":399,"canonicalKey":400,"locale":8,"draft":6,"navigation":401,"icon":402,"path":403},"Connection State","content:docs:4.build:6.application-behavior:1.connection-state.md","4\u002F6\u002F1",{"icon":402},"i-lucide-wifi","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fconnection-state",{"title":405,"id":406,"canonicalKey":407,"locale":8,"draft":6,"navigation":408,"icon":409,"path":410},"Error Handling","content:docs:4.build:6.application-behavior:2.error-handling.md","4\u002F6\u002F2",{"icon":409},"i-lucide-circle-alert","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Ferror-handling",{"title":412,"id":413,"canonicalKey":414,"locale":8,"draft":6,"navigation":415,"icon":416,"path":417},"Logging","content:docs:4.build:6.application-behavior:3.logging.md","4\u002F6\u002F3",{"icon":416},"i-lucide-scroll-text","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Flogging",{"title":419,"id":420,"canonicalKey":421,"locale":8,"draft":6,"navigation":422,"icon":423,"path":424},"DevTools","content:docs:4.build:6.application-behavior:4.devtools.md","4\u002F6\u002F4",{"icon":423},"i-lucide-wrench","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fdevtools",{"title":426,"id":427,"canonicalKey":428,"locale":8,"draft":6,"navigation":429,"icon":430,"path":431},"Performance","content:docs:4.build:6.application-behavior:5.performance.md","4\u002F6\u002F5",{"icon":430},"i-lucide-chart-no-axes-combined","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fperformance",{"title":433,"page":6,"canonicalKey":434,"locale":8,"id":435,"draft":6,"icon":334,"children":436},"Agents and MCP","4\u002F7","content:docs:4.build:7.agents:.navigation.yml",[437,444],{"title":438,"id":439,"canonicalKey":440,"locale":8,"draft":6,"navigation":441,"icon":442,"path":443},"MCP on Convex","content:docs:4.build:7.agents:1.mcp.md","4\u002F7\u002F1",{"icon":442},"i-lucide-plug-zap","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp",{"title":445,"id":446,"canonicalKey":447,"locale":8,"draft":6,"navigation":448,"icon":100,"path":449},"Vue MCP Apps","content:docs:4.build:7.agents:2.mcp-apps.md","4\u002F7\u002F2",{"icon":100},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-apps",{"title":451,"page":6,"canonicalKey":452,"locale":8,"id":453,"draft":6,"icon":454,"children":455},"Recipes","5","content:docs:5.recipes:.navigation.yml","i-lucide-cooking-pot",[456,462,469,476,483,490,497,503],{"title":457,"id":458,"canonicalKey":459,"locale":8,"draft":6,"navigation":460,"icon":39,"path":461},"Protected Dashboard","content:docs:5.recipes:1.protected-dashboard.md","5\u002F1",{"icon":39},"\u002Fdocs\u002Frecipes\u002Fprotected-dashboard",{"title":463,"id":464,"canonicalKey":465,"locale":8,"draft":6,"navigation":466,"icon":467,"path":468},"Real-Time Feed","content:docs:5.recipes:2.realtime-feed.md","5\u002F2",{"icon":467},"i-lucide-messages-square","\u002Fdocs\u002Frecipes\u002Frealtime-feed",{"title":470,"id":471,"canonicalKey":472,"locale":8,"draft":6,"navigation":473,"icon":474,"path":475},"Optimistic Todo List","content:docs:5.recipes:3.optimistic-todo-list.md","5\u002F3",{"icon":474},"i-lucide-list-todo","\u002Fdocs\u002Frecipes\u002Foptimistic-todo-list",{"title":477,"id":478,"canonicalKey":479,"locale":8,"draft":6,"navigation":480,"icon":481,"path":482},"Infinite Scroll","content:docs:5.recipes:4.infinite-scroll.md","5\u002F4",{"icon":481},"i-lucide-mouse","\u002Fdocs\u002Frecipes\u002Finfinite-scroll",{"title":484,"id":485,"canonicalKey":486,"locale":8,"draft":6,"navigation":487,"icon":488,"path":489},"File Upload Form","content:docs:5.recipes:5.file-upload-form.md","5\u002F5",{"icon":488},"i-lucide-file-up","\u002Fdocs\u002Frecipes\u002Ffile-upload-form",{"title":491,"id":492,"canonicalKey":493,"locale":8,"draft":6,"navigation":494,"icon":495,"path":496},"Organization Permissions","content:docs:5.recipes:6.organization-permissions.md","5\u002F6",{"icon":495},"i-lucide-building-2","\u002Fdocs\u002Frecipes\u002Forganization-permissions",{"title":498,"id":499,"canonicalKey":500,"locale":8,"draft":6,"navigation":501,"icon":345,"path":502},"Authenticated Server Route","content:docs:5.recipes:7.authenticated-server-route.md","5\u002F7",{"icon":345},"\u002Fdocs\u002Frecipes\u002Fauthenticated-server-route",{"title":504,"id":505,"canonicalKey":506,"locale":8,"draft":6,"navigation":507,"icon":100,"path":508},"Public and Private Data","content:docs:5.recipes:8.public-and-private-data.md","5\u002F8",{"icon":100},"\u002Fdocs\u002Frecipes\u002Fpublic-and-private-data",{"title":510,"page":6,"canonicalKey":511,"locale":8,"id":512,"draft":6,"icon":513,"children":514},"Reference","6","content:docs:6.reference:.navigation.yml","i-lucide-braces",[515,521,527,533,540,547],{"title":516,"id":517,"canonicalKey":518,"locale":8,"draft":6,"navigation":519,"icon":513,"path":520},"Composables","content:docs:6.reference:1.composables.md","6\u002F1",{"icon":513},"\u002Fdocs\u002Freference\u002Fcomposables",{"title":522,"id":523,"canonicalKey":524,"locale":8,"draft":6,"navigation":525,"icon":345,"path":526},"Server API","content:docs:6.reference:3.server-api.md","6\u002F3",{"icon":345},"\u002Fdocs\u002Freference\u002Fserver-api",{"title":528,"id":529,"canonicalKey":530,"locale":8,"draft":6,"navigation":531,"icon":107,"path":532},"Error Types","content:docs:6.reference:4.error-types.md","6\u002F4",{"icon":107},"\u002Fdocs\u002Freference\u002Ferror-types",{"title":534,"id":535,"canonicalKey":536,"locale":8,"draft":6,"navigation":537,"icon":538,"path":539},"Module Configuration","content:docs:6.reference:5.module-configuration.md","6\u002F5",{"icon":538},"i-lucide-settings","\u002Fdocs\u002Freference\u002Fmodule-configuration",{"title":541,"id":542,"canonicalKey":543,"locale":8,"draft":6,"navigation":544,"icon":545,"path":546},"Package Exports","content:docs:6.reference:6.package-exports.md","6\u002F6",{"icon":545},"i-lucide-package-open","\u002Fdocs\u002Freference\u002Fpackage-exports",{"title":548,"id":549,"canonicalKey":550,"locale":8,"draft":6,"navigation":551,"icon":552,"path":553},"API Surface","content:docs:6.reference:7.api-surface.md","6\u002F7",{"icon":552},"i-lucide-list","\u002Fdocs\u002Freference\u002Fapi-surface",{"title":555,"page":6,"canonicalKey":556,"locale":8,"id":557,"draft":6,"icon":280,"children":558},"Operations","7","content:docs:7.operations:.navigation.yml",[559,566,572,578,584],{"title":560,"id":561,"canonicalKey":562,"locale":8,"draft":6,"navigation":563,"icon":564,"path":565},"Environment Variables","content:docs:7.operations:1.environment-variables.md","7\u002F1",{"icon":564},"i-lucide-variable","\u002Fdocs\u002Foperations\u002Fenvironment-variables",{"title":567,"id":568,"canonicalKey":569,"locale":8,"draft":6,"navigation":570,"icon":127,"path":571},"Deployment","content:docs:7.operations:2.deployment.md","7\u002F2",{"icon":127},"\u002Fdocs\u002Foperations\u002Fdeployment",{"title":573,"id":574,"canonicalKey":575,"locale":8,"draft":6,"navigation":576,"icon":169,"path":577},"Security Model","content:docs:7.operations:3.security-model.md","7\u002F3",{"icon":169},"\u002Fdocs\u002Foperations\u002Fsecurity-model",{"title":579,"id":580,"canonicalKey":581,"locale":8,"draft":6,"navigation":582,"icon":423,"path":583},"Troubleshooting","content:docs:7.operations:4.troubleshooting.md","7\u002F4",{"icon":423},"\u002Fdocs\u002Foperations\u002Ftroubleshooting",{"title":585,"id":586,"canonicalKey":587,"locale":8,"draft":6,"navigation":588,"icon":25,"path":589},"Release Compatibility","content:docs:7.operations:5.release-compatibility.md","7\u002F5",{"icon":25},"\u002Fdocs\u002Foperations\u002Frelease-compatibility",{"title":591,"id":592,"canonicalKey":593,"locale":8,"draft":6,"path":594},"Better Convex documentation","content:docs:index.md","\u002F","\u002Fdocs",{"title":567,"description":596,"navigation":597,"body":598,"type":1056,"id":568,"canonicalKey":569,"draft":6,"partial":6,"locale":8,"collection":1057,"navigationFile":6,"file":1058,"route":1064,"resolution":1066},"Deploy a Nuxt and Convex application with the correct SSR, realtime, and authentication boundaries.",{"icon":127},{"type":599,"children":600,"toc":1046},"root",[601,609,616,621,646,673,679,755,807,840,846,971,984,990,1001,1007,1012,1035],{"type":602,"tag":603,"props":604,"children":605},"element","p",{},[606],{"type":607,"value":608},"text","Deploy Convex and Nuxt as two coordinated services. Convex owns the database and functions. Nuxt owns rendering, browser delivery, server routes, and the same-origin auth proxy.",{"type":602,"tag":610,"props":611,"children":613},"h2",{"id":612},"choose-a-supported-topology",[614],{"type":607,"value":615},"Choose a supported topology",{"type":602,"tag":603,"props":617,"children":618},{},[619],{"type":607,"value":620},"The normal topology is:",{"type":602,"tag":622,"props":623,"children":624},"ul",{},[625,631,636,641],{"type":602,"tag":626,"props":627,"children":628},"li",{},[629],{"type":607,"value":630},"a Convex cloud deployment;",{"type":602,"tag":626,"props":632,"children":633},{},[634],{"type":607,"value":635},"a Nuxt deployment with Nitro server support;",{"type":602,"tag":626,"props":637,"children":638},{},[639],{"type":607,"value":640},"one public HTTPS origin for the Nuxt application;",{"type":602,"tag":626,"props":642,"children":643},{},[644],{"type":607,"value":645},"browser access to Convex HTTPS and WebSocket endpoints.",{"type":602,"tag":603,"props":647,"children":648},{},[649,651,657,659,664,666,671],{"type":607,"value":650},"Authentication requires an explicit ",{"type":602,"tag":652,"props":653,"children":654},"code",{},[655],{"type":607,"value":656},"convex.auth",{"type":607,"value":658}," object and the generated ",{"type":602,"tag":652,"props":660,"children":661},{},[662],{"type":607,"value":663},"\u002Fapi\u002Fauth\u002F*",{"type":607,"value":665}," Nitro route. A fully static host without Nitro is not a supported auth topology. An app that omits auth can use Nuxt's static output, but only after its own SSR and client-navigation behavior is verified. Use ",{"type":602,"tag":652,"props":667,"children":668},{},[669],{"type":607,"value":670},"auth: false",{"type":607,"value":672}," only when a Nuxt layer must erase inherited auth configuration.",{"type":602,"tag":610,"props":674,"children":676},{"id":675},"deployment-order",[677],{"type":607,"value":678},"Deployment order",{"type":602,"tag":680,"props":681,"children":682},"ol",{},[683,688,721,733,745,750],{"type":602,"tag":626,"props":684,"children":685},{},[686],{"type":607,"value":687},"Deploy the Convex schema, functions, HTTP routes, and auth component.",{"type":602,"tag":626,"props":689,"children":690},{},[691,693,698,700,705,707,712,714,719],{"type":607,"value":692},"Set the Convex ",{"type":602,"tag":652,"props":694,"children":695},{},[696],{"type":607,"value":697},"SITE_URL",{"type":607,"value":699},", ",{"type":602,"tag":652,"props":701,"children":702},{},[703],{"type":607,"value":704},"BETTER_AUTH_SECRETS",{"type":607,"value":706},", and ",{"type":602,"tag":652,"props":708,"children":709},{},[710],{"type":607,"value":711},"BCN_AUTH_PROXY_IP_SECRET",{"type":607,"value":713}," variables. Convex injects its deployment-owned ",{"type":602,"tag":652,"props":715,"children":716},{},[717],{"type":607,"value":718},"CONVEX_SITE_URL",{"type":607,"value":720}," built-in automatically.",{"type":602,"tag":626,"props":722,"children":723},{},[724,726,731],{"type":607,"value":725},"Run the internal ",{"type":602,"tag":652,"props":727,"children":728},{},[729],{"type":607,"value":730},"auth:rotateSigningKey",{"type":607,"value":732}," operator action before admitting auth traffic.",{"type":602,"tag":626,"props":734,"children":735},{},[736,738,743],{"type":607,"value":737},"Build and deploy Nuxt behind a closed traffic gate, then verify the returned ",{"type":602,"tag":652,"props":739,"children":740},{},[741],{"type":607,"value":742},"newKid",{"type":607,"value":744}," is present in public JWKS.",{"type":602,"tag":626,"props":746,"children":747},{},[748],{"type":607,"value":749},"For delegated OAuth, provision and verify clients, resources, and links through the provider-owned admin API.",{"type":602,"tag":626,"props":751,"children":752},{},[753],{"type":607,"value":754},"Verify the deployed origins and auth ceremony, then open public ingress.",{"type":602,"tag":756,"props":757,"children":760},"pre",{"language":758,"class":759},"bash","shiki shiki-themes light-plus dark-plus dark:dark-plus",[761],{"type":602,"tag":652,"props":762,"children":764},{"class":763},"language-bash",[765,793,795],{"type":602,"tag":766,"props":767,"children":770},"span",{"class":768,"style":769},"line","display: inline",[771,777,783,788],{"type":602,"tag":766,"props":772,"children":774},{"style":773},"color:#795E26;--shiki-dark:#DCDCAA",[775],{"type":607,"value":776},"pnpm",{"type":602,"tag":766,"props":778,"children":780},{"style":779},"color:#A31515;--shiki-dark:#CE9178",[781],{"type":607,"value":782}," exec",{"type":602,"tag":766,"props":784,"children":785},{"style":779},[786],{"type":607,"value":787}," better-convex-nuxt-convex",{"type":602,"tag":766,"props":789,"children":790},{"style":779},[791],{"type":607,"value":792}," deploy",{"type":607,"value":794},"\n",{"type":602,"tag":766,"props":796,"children":797},{"class":768,"style":769},[798,802],{"type":602,"tag":766,"props":799,"children":800},{"style":773},[801],{"type":607,"value":776},{"type":602,"tag":766,"props":803,"children":804},{"style":779},[805],{"type":607,"value":806}," build",{"type":602,"tag":603,"props":808,"children":809},{},[810,812,817,819,824,826,831,833,838],{"type":607,"value":811},"The owner-only ",{"type":602,"tag":652,"props":813,"children":814},{},[815],{"type":607,"value":816},".env.local",{"type":607,"value":818}," used here must contain either the intended\nproduction deployment's scoped ",{"type":602,"tag":652,"props":820,"children":821},{},[822],{"type":607,"value":823},"CONVEX_DEPLOY_KEY",{"type":607,"value":825}," (or its supported alias) or\nan exact self-hosted URL\u002Fadmin-key pair. The checked runner rejects a plain\n",{"type":602,"tag":652,"props":827,"children":828},{},[829],{"type":607,"value":830},"CONVEX_DEPLOYMENT",{"type":607,"value":832}," for ",{"type":602,"tag":652,"props":834,"children":835},{},[836],{"type":607,"value":837},"deploy",{"type":607,"value":839},", because the pinned CLI interprets that value as\nproject context and silently targets the project's production deployment.\nInspect the deployment-scoped key immediately before the command. Ambient,\nsibling-file, project-key, preview-project-key, and command-line target\noverrides are rejected.",{"type":602,"tag":610,"props":841,"children":843},{"id":842},"production-checklist",[844],{"type":607,"value":845},"Production checklist",{"type":602,"tag":622,"props":847,"children":848},{},[849,854,872,889,906,924,929,941,946,951,956,961,966],{"type":602,"tag":626,"props":850,"children":851},{},[852],{"type":607,"value":853},"Use the exact Node, Nuxt, and Convex tuple in the package manifest. When auth is enabled, install the exact Better Auth and OAuth Provider optional peers explicitly.",{"type":602,"tag":626,"props":855,"children":856},{},[857,859,863,865,870],{"type":607,"value":858},"Set an exact HTTPS ",{"type":602,"tag":652,"props":860,"children":861},{},[862],{"type":607,"value":697},{"type":607,"value":864}," without a trailing path and pass that same value as ",{"type":602,"tag":652,"props":866,"children":867},{},[868],{"type":607,"value":869},"convex.auth.origin",{"type":607,"value":871},".",{"type":602,"tag":626,"props":873,"children":874},{},[875,877,881,883,887],{"type":607,"value":876},"Keep ",{"type":602,"tag":652,"props":878,"children":879},{},[880],{"type":607,"value":704},{"type":607,"value":882}," out of Nuxt entirely and keep ",{"type":602,"tag":652,"props":884,"children":885},{},[886],{"type":607,"value":711},{"type":607,"value":888}," out of public config and logs.",{"type":602,"tag":626,"props":890,"children":891},{},[892,894,899,901,905],{"type":607,"value":893},"Configure Nuxt's ",{"type":602,"tag":652,"props":895,"children":896},{},[897],{"type":607,"value":898},"NUXT_PUBLIC_CONVEX_SITE_URL",{"type":607,"value":900}," to the exact deployed HTTP Actions origin; do not try to override Convex's built-in ",{"type":602,"tag":652,"props":902,"children":903},{},[904],{"type":607,"value":718},{"type":607,"value":871},{"type":602,"tag":626,"props":907,"children":908},{},[909,911,915,917,922],{"type":607,"value":910},"Confirm ",{"type":602,"tag":652,"props":912,"children":913},{},[914],{"type":607,"value":663},{"type":607,"value":916}," reaches the intended ",{"type":602,"tag":652,"props":918,"children":919},{},[920],{"type":607,"value":921},".convex.site",{"type":607,"value":923}," origin.",{"type":602,"tag":626,"props":925,"children":926},{},[927],{"type":607,"value":928},"Permit the exact Convex HTTPS and WebSocket origins in Content Security Policy.",{"type":602,"tag":626,"props":930,"children":931},{},[932,934,939],{"type":607,"value":933},"Configure ",{"type":602,"tag":652,"props":935,"children":936},{},[937],{"type":607,"value":938},"convex.auth.trustedClientIpHeader",{"type":607,"value":940}," outside exact loopback development and make\nthe ingress overwrite it with exactly one client IP. Missing or malformed\nvalues fail closed before Better Auth.",{"type":602,"tag":626,"props":942,"children":943},{},[944],{"type":607,"value":945},"Restrict direct access to the Nuxt origin so public traffic can arrive only\nthrough that ingress, or independently authenticate ingress requests at the\norigin. A rewritten header is not a boundary when the origin is bypassable.",{"type":602,"tag":626,"props":947,"children":948},{},[949],{"type":607,"value":950},"Keep module logging off unless investigating a specific problem.",{"type":602,"tag":626,"props":952,"children":953},{},[954],{"type":607,"value":955},"Exercise sign-in, sign-out, SSR refresh, client navigation, and realtime reconnect.",{"type":602,"tag":626,"props":957,"children":958},{},[959],{"type":607,"value":960},"Verify backend authorization with two different users, not only UI visibility.",{"type":602,"tag":626,"props":962,"children":963},{},[964],{"type":607,"value":965},"Rehearse social-provider callbacks, recovery, expiry, denial, and rollback for every enabled provider.",{"type":602,"tag":626,"props":967,"children":968},{},[969],{"type":607,"value":970},"For delegated OAuth\u002FMCP, also rehearse consent, PKCE, wrong-client\u002Fresource\u002Fscope rejection, revocation, and live membership removal.",{"type":602,"tag":603,"props":972,"children":973},{},[974,976,982],{"type":607,"value":975},"The ",{"type":602,"tag":977,"props":978,"children":979},"a",{"href":335},[980],{"type":607,"value":981},"delegated OAuth and MCP guide",{"type":607,"value":983}," defines the pre-traffic key ceremony, fixed topology, deployment order, and forward-fix recovery policy. Do not replace it with first-request key creation or destructive JWKS cleanup.",{"type":602,"tag":610,"props":985,"children":987},{"id":986},"preview-deployments",[988],{"type":607,"value":989},"Preview deployments",{"type":602,"tag":603,"props":991,"children":992},{},[993,995,999],{"type":607,"value":994},"An arbitrary preview URL cannot safely reuse production auth configuration. Give stable previews their own Convex deployment, exact ",{"type":602,"tag":652,"props":996,"children":997},{},[998],{"type":607,"value":697},{"type":607,"value":1000},", and independent secrets, or disable auth for documentation-style previews. Wildcard trusted origins and shared production secrets weaken the boundary and are not a substitute for isolated environments.",{"type":602,"tag":610,"props":1002,"children":1004},{"id":1003},"health-checks",[1005],{"type":607,"value":1006},"Health checks",{"type":602,"tag":603,"props":1008,"children":1009},{},[1010],{"type":607,"value":1011},"A successful HTML response proves only that Nuxt started. Add checks that cover the actual dependency chain:",{"type":602,"tag":622,"props":1013,"children":1014},{},[1015,1020,1025,1030],{"type":602,"tag":626,"props":1016,"children":1017},{},[1018],{"type":607,"value":1019},"an anonymous Convex query;",{"type":602,"tag":626,"props":1021,"children":1022},{},[1023],{"type":607,"value":1024},"an authenticated server-rendered page when auth is enabled;",{"type":602,"tag":626,"props":1026,"children":1027},{},[1028],{"type":607,"value":1029},"a browser subscription receiving a change;",{"type":602,"tag":626,"props":1031,"children":1032},{},[1033],{"type":607,"value":1034},"the auth proxy rejecting unsupported methods and invalid upstream behavior.",{"type":602,"tag":603,"props":1036,"children":1037},{},[1038,1040,1044],{"type":607,"value":1039},"See ",{"type":602,"tag":977,"props":1041,"children":1042},{"href":577},[1043],{"type":607,"value":573},{"type":607,"value":1045}," before exposing the application publicly.",{"title":1047,"searchDepth":1048,"depth":1048,"links":1049},"",4,[1050,1052,1053,1054,1055],{"id":612,"depth":1051,"text":615},2,{"id":675,"depth":1051,"text":678},{"id":842,"depth":1051,"text":845},{"id":986,"depth":1051,"text":989},{"id":1003,"depth":1051,"text":1006},"markdown","docs",{"source":1059,"path":1060,"stem":1061,"dir":1062,"extension":1063},"content","docs\u002F7.operations\u002F2.deployment.md","docs\u002F7.operations\u002F2.deployment","operations","md",{"requestedPath":571,"resolvedPath":571,"alternates":1065},[],{"requested":1067,"resolved":1068,"usedFallback":6},{},{"locale":8},{"previous":1070,"next":1072},{"title":560,"id":561,"canonicalKey":562,"locale":8,"draft":6,"navigation":1071,"icon":564,"path":565},{"icon":564},{"title":573,"id":574,"canonicalKey":575,"locale":8,"draft":6,"navigation":1073,"icon":169,"path":577},{"icon":169},{"left":1075,"top":1075,"width":1076,"height":1076,"rotate":1075,"vFlip":6,"hFlip":6,"body":1077},0,24,"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 19h8M4 17l6-6l-6-6\"\u002F>",{"left":1075,"top":1075,"width":1076,"height":1076,"rotate":1075,"vFlip":6,"hFlip":6,"body":1079},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"8\" height=\"4\" x=\"8\" y=\"2\" rx=\"1\" ry=\"1\"\u002F>\u003Cpath d=\"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2\"\u002F>\u003C\u002Fg>",1786627532384]