[{"data":1,"prerenderedAt":1392},["ShallowReactive",2],{"docs-navigation:en":3,"content-page:docs:-wywgBjbw97G4A7SGg-n6A7sH9VqwSGE-j74o7e3Dfw":842,"content-page-surround:docs:-wywgBjbw97G4A7SGg-n6A7sH9VqwSGE-j74o7e3Dfw":1387},[4,41,110,540,643,708,772,837],{"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],{"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},"Who it is for","content:docs:1.overview:2.who-it-is-for.md","1\u002F2",{"icon":25},"i-lucide-users","\u002Fdocs\u002Foverview\u002Fwho-it-is-for",{"title":28,"id":29,"canonicalKey":30,"locale":8,"draft":6,"navigation":31,"icon":32,"path":33},"Limitations and trade-offs","content:docs:1.overview:3.limitations.md","1\u002F3",{"icon":32},"i-lucide-triangle-alert","\u002Fdocs\u002Foverview\u002Flimitations",{"title":35,"id":36,"canonicalKey":37,"locale":8,"draft":6,"navigation":38,"icon":39,"path":40},"Compare Nuxt integrations","content:docs:1.overview:4.comparison.md","1\u002F4",{"icon":39},"i-lucide-scale","\u002Fdocs\u002Foverview\u002Fcomparison",{"title":42,"page":6,"canonicalKey":43,"locale":8,"id":44,"draft":6,"icon":45,"children":46},"Get started","2","content:docs:2.get-started:.navigation.yml","i-lucide-rocket",[47,54,61,68,75,82,89,96,103],{"title":48,"id":49,"canonicalKey":50,"locale":8,"draft":6,"navigation":51,"icon":52,"path":53},"Choose your path","content:docs:2.get-started:1.choose-your-path.md","2\u002F1",{"icon":52},"i-lucide-signpost","\u002Fdocs\u002Fget-started\u002Fchoose-your-path",{"title":55,"id":56,"canonicalKey":57,"locale":8,"draft":6,"navigation":58,"icon":59,"path":60},"Installation","content:docs:2.get-started:2.installation.md","2\u002F2",{"icon":59},"i-lucide-download","\u002Fdocs\u002Fget-started\u002Finstallation",{"title":62,"id":63,"canonicalKey":64,"locale":8,"draft":6,"navigation":65,"icon":66,"path":67},"First real-time page","content:docs:2.get-started:3.first-realtime-page.md","2\u002F3",{"icon":66},"i-lucide-radio","\u002Fdocs\u002Fget-started\u002Ffirst-realtime-page",{"title":69,"id":70,"canonicalKey":71,"locale":8,"draft":6,"navigation":72,"icon":73,"path":74},"Complete and delete","content:docs:2.get-started:4.complete-and-delete.md","2\u002F4",{"icon":73},"i-lucide-square-check","\u002Fdocs\u002Fget-started\u002Fcomplete-and-delete",{"title":76,"id":77,"canonicalKey":78,"locale":8,"draft":6,"navigation":79,"icon":80,"path":81},"Add authentication","content:docs:2.get-started:5.add-authentication.md","2\u002F5",{"icon":80},"i-lucide-log-in","\u002Fdocs\u002Fget-started\u002Fadd-authentication",{"title":83,"id":84,"canonicalKey":85,"locale":8,"draft":6,"navigation":86,"icon":87,"path":88},"Protect data","content:docs:2.get-started:6.protect-data.md","2\u002F6",{"icon":87},"i-lucide-shield-check","\u002Fdocs\u002Fget-started\u002Fprotect-data",{"title":90,"id":91,"canonicalKey":92,"locale":8,"draft":6,"navigation":93,"icon":94,"path":95},"Project structure","content:docs:2.get-started:7.project-structure.md","2\u002F7",{"icon":94},"i-lucide-folder-tree","\u002Fdocs\u002Fget-started\u002Fproject-structure",{"title":97,"id":98,"canonicalKey":99,"locale":8,"draft":6,"navigation":100,"icon":101,"path":102},"Next steps","content:docs:2.get-started:8.next-steps.md","2\u002F8",{"icon":101},"i-lucide-arrow-right","\u002Fdocs\u002Fget-started\u002Fnext-steps",{"title":104,"id":105,"canonicalKey":106,"locale":8,"draft":6,"navigation":107,"icon":108,"path":109},"Plain Vue and Vite","content:docs:2.get-started:9.plain-vue.md","2\u002F9",{"icon":108},"i-lucide-panels-top-left","\u002Fdocs\u002Fget-started\u002Fplain-vue",{"title":111,"page":6,"canonicalKey":112,"locale":8,"id":113,"draft":6,"icon":114,"sidebar":11,"children":115},"Build","3","content:docs:3.build:.navigation.yml","i-lucide-blocks",[116,154,200,321,353,385,431,481],{"title":117,"page":6,"canonicalKey":118,"locale":8,"children":119},"Queries","3\u002F1",[120,126,133,140,147],{"title":117,"id":121,"canonicalKey":122,"locale":8,"draft":6,"navigation":123,"icon":124,"path":125},"content:docs:3.build:1.queries:1.queries.md","3\u002F1\u002F1",{"icon":124},"i-lucide-database","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fqueries",{"title":127,"id":128,"canonicalKey":129,"locale":8,"draft":6,"navigation":130,"icon":131,"path":132},"Reactive arguments","content:docs:3.build:1.queries:2.reactive-arguments.md","3\u002F1\u002F2",{"icon":131},"i-lucide-sliders-horizontal","\u002Fdocs\u002Fbuild\u002Fqueries\u002Freactive-arguments",{"title":134,"id":135,"canonicalKey":136,"locale":8,"draft":6,"navigation":137,"icon":138,"path":139},"Loading and stale data","content:docs:3.build:1.queries:3.loading-and-stale-data.md","3\u002F1\u002F3",{"icon":138},"i-lucide-loader-circle","\u002Fdocs\u002Fbuild\u002Fqueries\u002Floading-and-stale-data",{"title":141,"id":142,"canonicalKey":143,"locale":8,"draft":6,"navigation":144,"icon":145,"path":146},"Query execution options","content:docs:3.build:1.queries:4.ssr-options.md","3\u002F1\u002F4",{"icon":145},"i-lucide-server-cog","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fssr-options",{"title":148,"id":149,"canonicalKey":150,"locale":8,"draft":6,"navigation":151,"icon":152,"path":153},"Pagination","content:docs:3.build:1.queries:6.pagination.md","3\u002F1\u002F6",{"icon":152},"i-lucide-list-plus","\u002Fdocs\u002Fbuild\u002Fqueries\u002Fpagination",{"title":155,"page":6,"canonicalKey":156,"locale":8,"children":157},"Write Data","3\u002F2",[158,165,172,179,186,193],{"title":159,"id":160,"canonicalKey":161,"locale":8,"draft":6,"navigation":162,"icon":163,"path":164},"Mutations","content:docs:3.build:2.write-data:1.mutations.md","3\u002F2\u002F1",{"icon":163},"i-lucide-square-pen","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmutations",{"title":166,"id":167,"canonicalKey":168,"locale":8,"draft":6,"navigation":169,"icon":170,"path":171},"Actions","content:docs:3.build:2.write-data:2.actions.md","3\u002F2\u002F2",{"icon":170},"i-lucide-zap","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Factions",{"title":173,"id":174,"canonicalKey":175,"locale":8,"draft":6,"navigation":176,"icon":177,"path":178},"Optimistic updates","content:docs:3.build:2.write-data:3.optimistic-updates.md","3\u002F2\u002F3",{"icon":177},"i-lucide-gauge","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Foptimistic-updates",{"title":180,"id":181,"canonicalKey":182,"locale":8,"draft":6,"navigation":183,"icon":184,"path":185},"Concurrent operations","content:docs:3.build:2.write-data:4.concurrent-operations.md","3\u002F2\u002F4",{"icon":184},"i-lucide-git-fork","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fconcurrent-operations",{"title":187,"id":188,"canonicalKey":189,"locale":8,"draft":6,"navigation":190,"icon":191,"path":192},"Form submissions","content:docs:3.build:2.write-data:5.forms.md","3\u002F2\u002F5",{"icon":191},"i-lucide-list-checks","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fforms",{"title":194,"id":195,"canonicalKey":196,"locale":8,"draft":6,"navigation":197,"icon":198,"path":199},"Multi-step operations","content:docs:3.build:2.write-data:6.multi-step-operations.md","3\u002F2\u002F6",{"icon":198},"i-lucide-list-ordered","\u002Fdocs\u002Fbuild\u002Fwrite-data\u002Fmulti-step-operations",{"title":201,"page":6,"canonicalKey":202,"locale":8,"children":203},"Authentication","3\u002F3",[204,210,217,224,230,237,244,251,258,265,272,279,286,293,300,307,314],{"title":201,"id":205,"canonicalKey":206,"locale":8,"draft":6,"navigation":207,"icon":208,"path":209},"content:docs:3.build:3.authentication:1.overview.md","3\u002F3\u002F1",{"icon":208},"i-lucide-shield","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Foverview",{"title":211,"id":212,"canonicalKey":213,"locale":8,"draft":6,"navigation":214,"icon":215,"path":216},"Better Auth setup","content:docs:3.build:3.authentication:2.better-auth-setup.md","3\u002F3\u002F2",{"icon":215},"i-lucide-settings-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-setup",{"title":218,"id":219,"canonicalKey":220,"locale":8,"draft":6,"navigation":221,"icon":222,"path":223},"Auth state and user data","content:docs:3.build:3.authentication:3.auth-state-and-user.md","3\u002F3\u002F3",{"icon":222},"i-lucide-user-round","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fauth-state-and-user",{"title":225,"id":226,"canonicalKey":227,"locale":8,"draft":6,"navigation":228,"icon":80,"path":229},"Sign in and sign out","content:docs:3.build:3.authentication:4.sign-in-and-sign-out.md","3\u002F3\u002F4",{"icon":80},"\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsign-in-and-sign-out",{"title":231,"id":232,"canonicalKey":233,"locale":8,"draft":6,"navigation":234,"icon":235,"path":236},"Route protection","content:docs:3.build:3.authentication:5.route-protection.md","3\u002F3\u002F5",{"icon":235},"i-lucide-route","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Froute-protection",{"title":238,"id":239,"canonicalKey":240,"locale":8,"draft":6,"navigation":241,"icon":242,"path":243},"Backend authorization","content:docs:3.build:3.authentication:6.backend-authorization.md","3\u002F3\u002F6",{"icon":242},"i-lucide-lock-keyhole","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbackend-authorization",{"title":245,"id":246,"canonicalKey":247,"locale":8,"draft":6,"navigation":248,"icon":249,"path":250},"Better Auth plugins","content:docs:3.build:3.authentication:7.better-auth-plugins.md","3\u002F3\u002F7",{"icon":249},"i-lucide-plug","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugins",{"title":252,"id":253,"canonicalKey":254,"locale":8,"draft":6,"navigation":255,"icon":256,"path":257},"Custom user fields","content:docs:3.build:3.authentication:8.custom-user-fields.md","3\u002F3\u002F8",{"icon":256},"i-lucide-user-cog","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcustom-user-fields",{"title":259,"id":260,"canonicalKey":261,"locale":8,"draft":6,"navigation":262,"icon":263,"path":264},"User synchronization","content:docs:3.build:3.authentication:9.user-synchronization.md","3\u002F3\u002F9",{"icon":263},"i-lucide-refresh-ccw","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fuser-synchronization",{"title":266,"id":267,"canonicalKey":268,"locale":8,"draft":6,"navigation":269,"icon":270,"path":271},"Delegated OAuth and MCP","content:docs:3.build:3.authentication:10.delegated-oauth-and-mcp.md","3\u002F3\u002F10",{"icon":270},"i-lucide-bot","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fdelegated-oauth-and-mcp",{"title":273,"id":274,"canonicalKey":275,"locale":8,"draft":6,"navigation":276,"icon":277,"path":278},"Transactional auth email","content:docs:3.build:3.authentication:11.transactional-email.md","3\u002F3\u002F11",{"icon":277},"i-lucide-mail","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Ftransactional-email",{"title":280,"id":281,"canonicalKey":282,"locale":8,"draft":6,"navigation":283,"icon":284,"path":285},"Social sign-in","content:docs:3.build:3.authentication:12.social-sign-in.md","3\u002F3\u002F12",{"icon":284},"i-lucide-github","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fsocial-sign-in",{"title":287,"id":288,"canonicalKey":289,"locale":8,"draft":6,"navigation":290,"icon":291,"path":292},"Better Auth plugin support","content:docs:3.build:3.authentication:13.better-auth-plugin-support.md","3\u002F3\u002F13",{"icon":291},"i-lucide-puzzle","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fbetter-auth-plugin-support",{"title":294,"id":295,"canonicalKey":296,"locale":8,"draft":6,"navigation":297,"icon":298,"path":299},"Cacheable public pages","content:docs:3.build:3.authentication:14.cacheable-public-pages.md","3\u002F3\u002F14",{"icon":298},"i-lucide-globe","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcacheable-public-pages",{"title":301,"id":302,"canonicalKey":303,"locale":8,"draft":6,"navigation":304,"icon":305,"path":306},"Several sites on one deployment","content:docs:3.build:3.authentication:15.multiple-site-origins.md","3\u002F3\u002F15",{"icon":305},"i-lucide-network","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fmultiple-site-origins",{"title":308,"id":309,"canonicalKey":310,"locale":8,"draft":6,"navigation":311,"icon":312,"path":313},"Account deletion","content:docs:3.build:3.authentication:16.account-deletion.md","3\u002F3\u002F16",{"icon":312},"i-lucide-user-x","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Faccount-deletion",{"title":315,"id":316,"canonicalKey":317,"locale":8,"draft":6,"navigation":318,"icon":319,"path":320},"Company sign-in (OIDC)","content:docs:3.build:3.authentication:17.company-sign-in.md","3\u002F3\u002F17",{"icon":319},"i-lucide-building-2","\u002Fdocs\u002Fbuild\u002Fauthentication\u002Fcompany-sign-in",{"title":322,"page":6,"canonicalKey":323,"locale":8,"children":324},"Server","3\u002F4",[325,332,339,346],{"title":326,"id":327,"canonicalKey":328,"locale":8,"draft":6,"navigation":329,"icon":330,"path":331},"serverConvex","content:docs:3.build:4.server:1.server-convex.md","3\u002F4\u002F1",{"icon":330},"i-lucide-server","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-convex",{"title":333,"id":334,"canonicalKey":335,"locale":8,"draft":6,"navigation":336,"icon":337,"path":338},"Server routes","content:docs:3.build:4.server:2.server-routes.md","3\u002F4\u002F2",{"icon":337},"i-lucide-waypoints","\u002Fdocs\u002Fbuild\u002Fserver\u002Fserver-routes",{"title":340,"id":341,"canonicalKey":342,"locale":8,"draft":6,"navigation":343,"icon":344,"path":345},"Webhooks and jobs","content:docs:3.build:4.server:3.webhooks-and-jobs.md","3\u002F4\u002F3",{"icon":344},"i-lucide-webhook","\u002Fdocs\u002Fbuild\u002Fserver\u002Fwebhooks-and-jobs",{"title":347,"id":348,"canonicalKey":349,"locale":8,"draft":6,"navigation":350,"icon":351,"path":352},"Credentials and server security","content:docs:3.build:4.server:4.credentials-and-security.md","3\u002F4\u002F4",{"icon":351},"i-lucide-key-round","\u002Fdocs\u002Fbuild\u002Fserver\u002Fcredentials-and-security",{"title":354,"page":6,"canonicalKey":355,"locale":8,"children":356},"Files","3\u002F5",[357,364,371,378],{"title":358,"id":359,"canonicalKey":360,"locale":8,"draft":6,"navigation":361,"icon":362,"path":363},"Upload files","content:docs:3.build:5.files:1.upload-files.md","3\u002F5\u002F1",{"icon":362},"i-lucide-upload","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fupload-files",{"title":365,"id":366,"canonicalKey":367,"locale":8,"draft":6,"navigation":368,"icon":369,"path":370},"Storage URLs","content:docs:3.build:5.files:3.storage-urls.md","3\u002F5\u002F3",{"icon":369},"i-lucide-link","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fstorage-urls",{"title":372,"id":373,"canonicalKey":374,"locale":8,"draft":6,"navigation":375,"icon":376,"path":377},"File validation and deletion","content:docs:3.build:5.files:4.validation-and-deletion.md","3\u002F5\u002F4",{"icon":376},"i-lucide-file-x","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fvalidation-and-deletion",{"title":379,"id":380,"canonicalKey":381,"locale":8,"draft":6,"navigation":382,"icon":383,"path":384},"Private downloads","content:docs:3.build:5.files:5.private-downloads.md","3\u002F5\u002F5",{"icon":383},"i-lucide-file-lock","\u002Fdocs\u002Fbuild\u002Ffiles\u002Fprivate-downloads",{"title":386,"page":6,"canonicalKey":387,"locale":8,"children":388},"Application Behavior","3\u002F6",[389,396,403,410,417,424],{"title":390,"id":391,"canonicalKey":392,"locale":8,"draft":6,"navigation":393,"icon":394,"path":395},"Connection state","content:docs:3.build:6.application-behavior:1.connection-state.md","3\u002F6\u002F1",{"icon":394},"i-lucide-wifi","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fconnection-state",{"title":397,"id":398,"canonicalKey":399,"locale":8,"draft":6,"navigation":400,"icon":401,"path":402},"Error handling","content:docs:3.build:6.application-behavior:2.error-handling.md","3\u002F6\u002F2",{"icon":401},"i-lucide-circle-alert","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Ferror-handling",{"title":404,"id":405,"canonicalKey":406,"locale":8,"draft":6,"navigation":407,"icon":408,"path":409},"Logging","content:docs:3.build:6.application-behavior:3.logging.md","3\u002F6\u002F3",{"icon":408},"i-lucide-scroll-text","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Flogging",{"title":411,"id":412,"canonicalKey":413,"locale":8,"draft":6,"navigation":414,"icon":415,"path":416},"DevTools","content:docs:3.build:6.application-behavior:4.devtools.md","3\u002F6\u002F4",{"icon":415},"i-lucide-wrench","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fdevtools",{"title":418,"id":419,"canonicalKey":420,"locale":8,"draft":6,"navigation":421,"icon":422,"path":423},"Performance","content:docs:3.build:6.application-behavior:5.performance.md","3\u002F6\u002F5",{"icon":422},"i-lucide-chart-no-axes-combined","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fperformance",{"title":425,"id":426,"canonicalKey":427,"locale":8,"draft":6,"navigation":428,"icon":429,"path":430},"Start the client on demand","content:docs:3.build:6.application-behavior:6.on-demand-client.md","3\u002F6\u002F6",{"icon":429},"i-lucide-power","\u002Fdocs\u002Fbuild\u002Fapplication-behavior\u002Fon-demand-client",{"title":432,"page":6,"canonicalKey":433,"locale":8,"id":434,"draft":6,"icon":270,"children":435},"Agents and MCP","3\u002F7","content:docs:3.build:7.agents:.navigation.yml",[436,442,449,456,463,469,475],{"title":437,"id":438,"canonicalKey":439,"locale":8,"draft":6,"navigation":440,"icon":415,"path":441},"Tools and approvals","content:docs:3.build:7.agents:1.tools-and-approvals.md","3\u002F7\u002F1",{"icon":415},"\u002Fdocs\u002Fbuild\u002Fagents\u002Ftools-and-approvals",{"title":443,"id":444,"canonicalKey":445,"locale":8,"draft":6,"navigation":446,"icon":447,"path":448},"The MCP door","content:docs:3.build:7.agents:2.mcp-door.md","3\u002F7\u002F2",{"icon":447},"i-lucide-door-open","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-door",{"title":450,"id":451,"canonicalKey":452,"locale":8,"draft":6,"navigation":453,"icon":454,"path":455},"Limits","content:docs:3.build:7.agents:3.limits.md","3\u002F7\u002F3",{"icon":454},"i-lucide-traffic-cone","\u002Fdocs\u002Fbuild\u002Fagents\u002Flimits",{"title":457,"id":458,"canonicalKey":459,"locale":8,"draft":6,"navigation":460,"icon":461,"path":462},"MCP on Convex","content:docs:3.build:7.agents:4.mcp.md","3\u002F7\u002F4",{"icon":461},"i-lucide-plug-zap","\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp",{"title":464,"id":465,"canonicalKey":466,"locale":8,"draft":6,"navigation":467,"icon":249,"path":468},"Add MCP to your application","content:docs:3.build:7.agents:5.mcp-application.md","3\u002F7\u002F5",{"icon":249},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-application",{"title":470,"id":471,"canonicalKey":472,"locale":8,"draft":6,"navigation":473,"icon":369,"path":474},"Connect ChatGPT and Claude","content:docs:3.build:7.agents:6.connect-chatgpt-and-claude.md","3\u002F7\u002F6",{"icon":369},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fconnect-chatgpt-and-claude",{"title":476,"id":477,"canonicalKey":478,"locale":8,"draft":6,"navigation":479,"icon":108,"path":480},"MCP Apps","content:docs:3.build:7.agents:7.mcp-apps.md","3\u002F7\u002F7",{"icon":108},"\u002Fdocs\u002Fbuild\u002Fagents\u002Fmcp-apps",{"title":482,"page":6,"canonicalKey":483,"locale":8,"id":484,"draft":6,"icon":485,"children":486},"Operations and policy","3\u002F8","content:docs:3.build:8.functions:.navigation.yml","i-lucide-shield-half",[487,494,500,507,514,521,527,534],{"title":488,"id":489,"canonicalKey":490,"locale":8,"draft":6,"navigation":491,"icon":492,"path":493},"Start here","content:docs:3.build:8.functions:1.start-here.md","3\u002F8\u002F1",{"icon":492},"i-lucide-flag","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fstart-here",{"title":495,"id":496,"canonicalKey":497,"locale":8,"draft":6,"navigation":498,"icon":39,"path":499},"Policy and roles","content:docs:3.build:8.functions:2.policy-and-roles.md","3\u002F8\u002F2",{"icon":39},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fpolicy-and-roles",{"title":501,"id":502,"canonicalKey":503,"locale":8,"draft":6,"navigation":504,"icon":505,"path":506},"Row rules","content:docs:3.build:8.functions:3.row-rules.md","3\u002F8\u002F3",{"icon":505},"i-lucide-rows-3","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Frow-rules",{"title":508,"id":509,"canonicalKey":510,"locale":8,"draft":6,"navigation":511,"icon":512,"path":513},"Internal operations","content:docs:3.build:8.functions:4.internal-operations.md","3\u002F8\u002F4",{"icon":512},"i-lucide-workflow","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Finternal-operations",{"title":515,"id":516,"canonicalKey":517,"locale":8,"draft":6,"navigation":518,"icon":519,"path":520},"Test your app","content:docs:3.build:8.functions:5.testing.md","3\u002F8\u002F5",{"icon":519},"i-lucide-flask-conical","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Ftesting",{"title":522,"id":523,"canonicalKey":524,"locale":8,"draft":6,"navigation":525,"icon":177,"path":526},"Cost","content:docs:3.build:8.functions:6.cost.md","3\u002F8\u002F6",{"icon":177},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fcost",{"title":528,"id":529,"canonicalKey":530,"locale":8,"draft":6,"navigation":531,"icon":532,"path":533},"Threat model","content:docs:3.build:8.functions:7.threat-model.md","3\u002F8\u002F7",{"icon":532},"i-lucide-shield-alert","\u002Fdocs\u002Fbuild\u002Ffunctions\u002Fthreat-model",{"title":535,"id":536,"canonicalKey":537,"locale":8,"draft":6,"navigation":538,"icon":408,"path":539},"Rate limits, audit log and call events","content:docs:3.build:8.functions:8.limits-and-audit.md","3\u002F8\u002F8",{"icon":408},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Flimits-and-audit",{"title":541,"page":6,"canonicalKey":542,"locale":8,"id":543,"draft":6,"icon":544,"children":545},"Recipes","4","content:docs:4.recipes:.navigation.yml","i-lucide-cooking-pot",[546,553,560,567,574,581,587,593,599,605,612,619,626,633,638],{"title":547,"id":548,"canonicalKey":549,"locale":8,"draft":6,"navigation":550,"icon":551,"path":552},"Protected dashboard","content:docs:4.recipes:1.protected-dashboard.md","4\u002F1",{"icon":551},"i-lucide-layout-dashboard","\u002Fdocs\u002Frecipes\u002Fprotected-dashboard",{"title":554,"id":555,"canonicalKey":556,"locale":8,"draft":6,"navigation":557,"icon":558,"path":559},"Real-time feed","content:docs:4.recipes:2.realtime-feed.md","4\u002F2",{"icon":558},"i-lucide-messages-square","\u002Fdocs\u002Frecipes\u002Frealtime-feed",{"title":561,"id":562,"canonicalKey":563,"locale":8,"draft":6,"navigation":564,"icon":565,"path":566},"Optimistic todo list","content:docs:4.recipes:3.optimistic-todo-list.md","4\u002F3",{"icon":565},"i-lucide-list-todo","\u002Fdocs\u002Frecipes\u002Foptimistic-todo-list",{"title":568,"id":569,"canonicalKey":570,"locale":8,"draft":6,"navigation":571,"icon":572,"path":573},"Infinite scroll","content:docs:4.recipes:4.infinite-scroll.md","4\u002F4",{"icon":572},"i-lucide-mouse","\u002Fdocs\u002Frecipes\u002Finfinite-scroll",{"title":575,"id":576,"canonicalKey":577,"locale":8,"draft":6,"navigation":578,"icon":579,"path":580},"File upload form","content:docs:4.recipes:5.file-upload-form.md","4\u002F5",{"icon":579},"i-lucide-file-up","\u002Fdocs\u002Frecipes\u002Ffile-upload-form",{"title":582,"id":583,"canonicalKey":584,"locale":8,"draft":6,"navigation":585,"icon":319,"path":586},"Organization permissions","content:docs:4.recipes:6.organization-permissions.md","4\u002F6",{"icon":319},"\u002Fdocs\u002Frecipes\u002Forganization-permissions",{"title":588,"id":589,"canonicalKey":590,"locale":8,"draft":6,"navigation":591,"icon":330,"path":592},"Authenticated server route","content:docs:4.recipes:7.authenticated-server-route.md","4\u002F7",{"icon":330},"\u002Fdocs\u002Frecipes\u002Fauthenticated-server-route",{"title":594,"id":595,"canonicalKey":596,"locale":8,"draft":6,"navigation":597,"icon":108,"path":598},"Public and private data","content:docs:4.recipes:8.public-and-private-data.md","4\u002F8",{"icon":108},"\u002Fdocs\u002Frecipes\u002Fpublic-and-private-data",{"title":600,"id":601,"canonicalKey":602,"locale":8,"draft":6,"navigation":603,"icon":519,"path":604},"Test signed-in screens","content:docs:4.recipes:9.component-testing.md","4\u002F9",{"icon":519},"\u002Fdocs\u002Frecipes\u002Fcomponent-testing",{"title":606,"id":607,"canonicalKey":608,"locale":8,"draft":6,"navigation":609,"icon":610,"path":611},"Time-based data","content:docs:4.recipes:10.time-based-data.md","4\u002F10",{"icon":610},"i-lucide-clock","\u002Fdocs\u002Frecipes\u002Ftime-based-data",{"title":613,"id":614,"canonicalKey":615,"locale":8,"draft":6,"navigation":616,"icon":617,"path":618},"A list of queries","content:docs:4.recipes:11.dynamic-query-list.md","4\u002F11",{"icon":617},"i-lucide-list-tree","\u002Fdocs\u002Frecipes\u002Fdynamic-query-list",{"title":620,"id":621,"canonicalKey":622,"locale":8,"draft":6,"navigation":623,"icon":624,"path":625},"Error messages","content:docs:4.recipes:12.error-messages.md","4\u002F12",{"icon":624},"i-lucide-message-circle-warning","\u002Fdocs\u002Frecipes\u002Ferror-messages",{"title":627,"id":628,"canonicalKey":629,"locale":8,"draft":6,"navigation":630,"icon":631,"path":632},"Several file uploads","content:docs:4.recipes:13.multiple-file-uploads.md","4\u002F13",{"icon":631},"i-lucide-files","\u002Fdocs\u002Frecipes\u002Fmultiple-file-uploads",{"title":634,"id":635,"canonicalKey":636,"locale":8,"draft":6,"path":637},"Guest users","content:docs:4.recipes:15.guest-users.md","4\u002F15","\u002Fdocs\u002Frecipes\u002Fguest-users",{"title":639,"id":640,"canonicalKey":641,"locale":8,"draft":6,"path":642},"Sign-in link","content:docs:4.recipes:16.sign-in-link.md","4\u002F16","\u002Fdocs\u002Frecipes\u002Fsign-in-link",{"title":644,"page":6,"canonicalKey":645,"locale":8,"id":646,"draft":6,"icon":647,"children":648},"Concepts","5","content:docs:5.concepts:.navigation.yml","i-lucide-brain",[649,655,661,668,674,681,687,694,701],{"title":650,"id":651,"canonicalKey":652,"locale":8,"draft":6,"navigation":653,"icon":647,"path":654},"Mental model","content:docs:5.concepts:1.mental-model.md","5\u002F1",{"icon":647},"\u002Fdocs\u002Fconcepts\u002Fmental-model",{"title":656,"id":657,"canonicalKey":658,"locale":8,"draft":6,"navigation":659,"icon":235,"path":660},"Request lifecycle","content:docs:5.concepts:2.request-lifecycle.md","5\u002F2",{"icon":235},"\u002Fdocs\u002Fconcepts\u002Frequest-lifecycle",{"title":662,"id":663,"canonicalKey":664,"locale":8,"draft":6,"navigation":665,"icon":666,"path":667},"SSR, hydration, and real-time","content:docs:5.concepts:3.ssr-hydration-realtime.md","5\u002F3",{"icon":666},"i-lucide-refresh-cw","\u002Fdocs\u002Fconcepts\u002Fssr-hydration-realtime",{"title":669,"id":670,"canonicalKey":671,"locale":8,"draft":6,"navigation":672,"icon":124,"path":673},"Query state and caching","content:docs:5.concepts:4.query-ownership-and-caching.md","5\u002F4",{"icon":124},"\u002Fdocs\u002Fconcepts\u002Fquery-ownership-and-caching",{"title":675,"id":676,"canonicalKey":677,"locale":8,"draft":6,"navigation":678,"icon":679,"path":680},"Authentication and identity","content:docs:5.concepts:5.authentication-and-identity.md","5\u002F5",{"icon":679},"i-lucide-fingerprint","\u002Fdocs\u002Fconcepts\u002Fauthentication-and-identity",{"title":682,"id":683,"canonicalKey":684,"locale":8,"draft":6,"navigation":685,"icon":108,"path":686},"Server and client boundaries","content:docs:5.concepts:6.server-and-client-boundaries.md","5\u002F6",{"icon":108},"\u002Fdocs\u002Fconcepts\u002Fserver-and-client-boundaries",{"title":688,"id":689,"canonicalKey":690,"locale":8,"draft":6,"navigation":691,"icon":692,"path":693},"Errors and failures","content:docs:5.concepts:7.errors-and-failures.md","5\u002F7",{"icon":692},"i-lucide-circle-x","\u002Fdocs\u002Fconcepts\u002Ferrors-and-failures",{"title":695,"id":696,"canonicalKey":697,"locale":8,"draft":6,"navigation":698,"icon":699,"path":700},"Design decisions","content:docs:5.concepts:8.design-decisions.md","5\u002F8",{"icon":699},"i-lucide-git-branch","\u002Fdocs\u002Fconcepts\u002Fdesign-decisions",{"title":702,"id":703,"canonicalKey":704,"locale":8,"draft":6,"navigation":705,"icon":706,"path":707},"Glossary","content:docs:5.concepts:9.glossary.md","5\u002F9",{"icon":706},"i-lucide-book-a","\u002Fdocs\u002Fconcepts\u002Fglossary",{"title":709,"page":6,"canonicalKey":710,"locale":8,"id":711,"draft":6,"icon":215,"children":712},"Operations","6","content:docs:6.operations:.navigation.yml",[713,719,726,733,739,746,752,759,765],{"title":714,"id":715,"canonicalKey":716,"locale":8,"draft":6,"navigation":717,"icon":45,"path":718},"Deployment","content:docs:6.operations:1.deployment.md","6\u002F1",{"icon":45},"\u002Fdocs\u002Foperations\u002Fdeployment",{"title":720,"id":721,"canonicalKey":722,"locale":8,"draft":6,"navigation":723,"icon":724,"path":725},"Environment variables","content:docs:6.operations:2.environment-variables.md","6\u002F2",{"icon":724},"i-lucide-variable","\u002Fdocs\u002Foperations\u002Fenvironment-variables",{"title":727,"id":728,"canonicalKey":729,"locale":8,"draft":6,"navigation":730,"icon":731,"path":732},"Deploy to Vercel","content:docs:6.operations:3.deploy-to-vercel.md","6\u002F3",{"icon":731},"i-lucide-triangle","\u002Fdocs\u002Foperations\u002Fdeploy-to-vercel",{"title":734,"id":735,"canonicalKey":736,"locale":8,"draft":6,"navigation":737,"icon":415,"path":738},"Troubleshooting","content:docs:6.operations:4.troubleshooting.md","6\u002F4",{"icon":415},"\u002Fdocs\u002Foperations\u002Ftroubleshooting",{"title":740,"id":741,"canonicalKey":742,"locale":8,"draft":6,"navigation":743,"icon":744,"path":745},"Release compatibility","content:docs:6.operations:5.release-compatibility.md","6\u002F5",{"icon":744},"i-lucide-badge-check","\u002Fdocs\u002Foperations\u002Frelease-compatibility",{"title":747,"id":748,"canonicalKey":749,"locale":8,"draft":6,"navigation":750,"icon":87,"path":751},"Security model","content:docs:6.operations:6.security-model.md","6\u002F6",{"icon":87},"\u002Fdocs\u002Foperations\u002Fsecurity-model",{"title":753,"id":754,"canonicalKey":755,"locale":8,"draft":6,"navigation":756,"icon":757,"path":758},"Upgrade to 1.0","content:docs:6.operations:7.upgrade-to-1-0.md","6\u002F7",{"icon":757},"i-lucide-arrow-up-circle","\u002Fdocs\u002Foperations\u002Fupgrade-to-1-0",{"title":760,"id":761,"canonicalKey":762,"locale":8,"draft":6,"navigation":763,"icon":45,"path":764},"Before your app goes live","content:docs:6.operations:8.before-launch.md","6\u002F8",{"icon":45},"\u002Fdocs\u002Foperations\u002Fbefore-launch",{"title":766,"id":767,"canonicalKey":768,"locale":8,"draft":6,"navigation":769,"icon":770,"path":771},"Log streams and PostHog","content:docs:6.operations:9.log-streams.md","6\u002F9",{"icon":770},"i-lucide-activity","\u002Fdocs\u002Foperations\u002Flog-streams",{"title":773,"page":6,"canonicalKey":774,"locale":8,"id":775,"draft":6,"icon":776,"children":777},"Reference","7","content:docs:7.reference:.navigation.yml","i-lucide-braces",[778,784,790,796,803,810,817,823,830],{"title":779,"id":780,"canonicalKey":781,"locale":8,"draft":6,"navigation":782,"icon":776,"path":783},"Composables","content:docs:7.reference:1.composables.md","7\u002F1",{"icon":776},"\u002Fdocs\u002Freference\u002Fcomposables",{"title":785,"id":786,"canonicalKey":787,"locale":8,"draft":6,"navigation":788,"icon":330,"path":789},"Server API","content:docs:7.reference:3.server-api.md","7\u002F3",{"icon":330},"\u002Fdocs\u002Freference\u002Fserver-api",{"title":791,"id":792,"canonicalKey":793,"locale":8,"draft":6,"navigation":794,"icon":692,"path":795},"Error types","content:docs:7.reference:4.error-types.md","7\u002F4",{"icon":692},"\u002Fdocs\u002Freference\u002Ferror-types",{"title":797,"id":798,"canonicalKey":799,"locale":8,"draft":6,"navigation":800,"icon":801,"path":802},"Module configuration","content:docs:7.reference:5.module-configuration.md","7\u002F5",{"icon":801},"i-lucide-settings","\u002Fdocs\u002Freference\u002Fmodule-configuration",{"title":804,"id":805,"canonicalKey":806,"locale":8,"draft":6,"navigation":807,"icon":808,"path":809},"Package exports","content:docs:7.reference:6.package-exports.md","7\u002F6",{"icon":808},"i-lucide-package-open","\u002Fdocs\u002Freference\u002Fpackage-exports",{"title":811,"id":812,"canonicalKey":813,"locale":8,"draft":6,"navigation":814,"icon":815,"path":816},"API reference","content:docs:7.reference:7.api-surface.md","7\u002F7",{"icon":815},"i-lucide-list","\u002Fdocs\u002Freference\u002Fapi-surface",{"title":818,"id":819,"canonicalKey":820,"locale":8,"draft":6,"navigation":821,"icon":519,"path":822},"Experimental APIs","content:docs:7.reference:8.experimental.md","7\u002F8",{"icon":519},"\u002Fdocs\u002Freference\u002Fexperimental",{"title":824,"id":825,"canonicalKey":826,"locale":8,"draft":6,"navigation":827,"icon":828,"path":829},"Command line","content:docs:7.reference:9.cli.md","7\u002F9",{"icon":828},"i-lucide-terminal","\u002Fdocs\u002Freference\u002Fcli",{"title":831,"id":832,"canonicalKey":833,"locale":8,"draft":6,"navigation":834,"icon":835,"path":836},"Operation error codes","content:docs:7.reference:10.operation-error-codes.md","7\u002F10",{"icon":835},"i-lucide-octagon-alert","\u002Fdocs\u002Freference\u002Foperation-error-codes",{"title":838,"id":839,"canonicalKey":840,"locale":8,"draft":6,"path":841},"Better Convex documentation","content:docs:index.md","\u002F","\u002Fdocs",{"title":522,"description":843,"navigation":844,"body":845,"type":1374,"id":523,"canonicalKey":524,"draft":6,"partial":6,"locale":8,"collection":1375,"navigationFile":6,"file":1376,"route":1382,"resolution":1384},"What the library reads and writes around each call, measured in documents, and how to keep a budget for your own operations.",{"icon":177},{"type":846,"children":847,"toc":1364},"root",[848,856,863,876,1094,1100,1112,1117,1135,1141,1146,1277,1282,1294,1300,1313,1319],{"type":849,"tag":850,"props":851,"children":852},"element","p",{},[853],{"type":854,"value":855},"text","Convex bills and limits functions by the documents they read and write. The\nlibrary adds a fixed number of reads around each handler. It does not add a\nread for each row: a row rule reuses the role and the tenant rows that the\ncall already loaded.",{"type":849,"tag":857,"props":858,"children":860},"h2",{"id":859},"what-one-call-costs",[861],{"type":854,"value":862},"What one call costs",{"type":849,"tag":850,"props":864,"children":865},{},[866,868,874],{"type":854,"value":867},"Measured with ",{"type":849,"tag":869,"props":870,"children":871},"code",{},[872],{"type":854,"value":873},"countDocuments",{"type":854,"value":875}," in the tests of both packages. The numbers\ncount your tables and the library's own tables. The session check of the auth\ncomponent comes on top (see below).",{"type":849,"tag":877,"props":878,"children":879},"table",{},[880,909],{"type":849,"tag":881,"props":882,"children":883},"thead",{},[884],{"type":849,"tag":885,"props":886,"children":887},"tr",{},[888,894,899,904],{"type":849,"tag":889,"props":890,"children":891},"th",{},[892],{"type":854,"value":893},"Call",{"type":849,"tag":889,"props":895,"children":896},{},[897],{"type":854,"value":898},"Reads",{"type":849,"tag":889,"props":900,"children":901},{},[902],{"type":854,"value":903},"Writes",{"type":849,"tag":889,"props":905,"children":906},{},[907],{"type":854,"value":908},"What they are",{"type":849,"tag":910,"props":911,"children":912},"tbody",{},[913,936,971,992,1018,1039,1067],{"type":849,"tag":885,"props":914,"children":915},{},[916,922,926,931],{"type":849,"tag":917,"props":918,"children":919},"td",{},[920],{"type":854,"value":921},"A page of a list query, 3 rows",{"type":849,"tag":917,"props":923,"children":924},{},[925],{"type":854,"value":710},{"type":849,"tag":917,"props":927,"children":928},{},[929],{"type":854,"value":930},"0",{"type":849,"tag":917,"props":932,"children":933},{},[934],{"type":854,"value":935},"user, organization, membership, and the 3 rows. The row rules add nothing",{"type":849,"tag":885,"props":937,"children":938},{},[939,951,955,959],{"type":849,"tag":917,"props":940,"children":941},{},[942,944,949],{"type":854,"value":943},"A mutation of one row under a ",{"type":849,"tag":869,"props":945,"children":946},{},[947],{"type":854,"value":948},"tenant",{"type":854,"value":950}," rule",{"type":849,"tag":917,"props":952,"children":953},{},[954],{"type":854,"value":542},{"type":849,"tag":917,"props":956,"children":957},{},[958],{"type":854,"value":7},{"type":849,"tag":917,"props":960,"children":961},{},[962,964,969],{"type":854,"value":963},"user, the row (for its tenant), membership, and the patch's own read. The handler's ",{"type":849,"tag":869,"props":965,"children":966},{},[967],{"type":854,"value":968},"get",{"type":854,"value":970}," is free",{"type":849,"tag":885,"props":972,"children":973},{},[974,979,983,987],{"type":849,"tag":917,"props":975,"children":976},{},[977],{"type":854,"value":978},"A write in a nested tenant (a client of an agency)",{"type":849,"tag":917,"props":980,"children":981},{},[982],{"type":854,"value":112},{"type":849,"tag":917,"props":984,"children":985},{},[986],{"type":854,"value":7},{"type":849,"tag":917,"props":988,"children":989},{},[990],{"type":854,"value":991},"user, organization, membership. The parent check reuses the role",{"type":849,"tag":885,"props":993,"children":994},{},[995,1005,1009,1013],{"type":849,"tag":917,"props":996,"children":997},{},[998,1000],{"type":854,"value":999},"A tool call with a ",{"type":849,"tag":869,"props":1001,"children":1002},{},[1003],{"type":854,"value":1004},"request_id",{"type":849,"tag":917,"props":1006,"children":1007},{},[1008],{"type":854,"value":112},{"type":849,"tag":917,"props":1010,"children":1011},{},[1012],{"type":854,"value":112},{"type":849,"tag":917,"props":1014,"children":1015},{},[1016],{"type":854,"value":1017},"user, organization, membership; the rate-limit window, the row, the activity row",{"type":849,"tag":885,"props":1019,"children":1020},{},[1021,1026,1030,1034],{"type":849,"tag":917,"props":1022,"children":1023},{},[1024],{"type":854,"value":1025},"The same call again (a retry that replays)",{"type":849,"tag":917,"props":1027,"children":1028},{},[1029],{"type":854,"value":710},{"type":849,"tag":917,"props":1031,"children":1032},{},[1033],{"type":854,"value":7},{"type":849,"tag":917,"props":1035,"children":1036},{},[1037],{"type":854,"value":1038},"the same checks, the rate-limit window, and the stored activity row",{"type":849,"tag":885,"props":1040,"children":1041},{},[1042,1054,1058,1062],{"type":849,"tag":917,"props":1043,"children":1044},{},[1045,1047,1052],{"type":854,"value":1046},"A tool call that asks a person (",{"type":849,"tag":869,"props":1048,"children":1049},{},[1050],{"type":854,"value":1051},"'approve'",{"type":854,"value":1053},")",{"type":849,"tag":917,"props":1055,"children":1056},{},[1057],{"type":854,"value":542},{"type":849,"tag":917,"props":1059,"children":1060},{},[1061],{"type":854,"value":43},{"type":849,"tag":917,"props":1063,"children":1064},{},[1065],{"type":854,"value":1066},"user, the row (for its tenant), membership, the row again for the request's fingerprint; the rate-limit window, the request",{"type":849,"tag":885,"props":1068,"children":1069},{},[1070,1080,1085,1089],{"type":849,"tag":917,"props":1071,"children":1072},{},[1073,1078],{"type":849,"tag":869,"props":1074,"children":1075},{},[1076],{"type":854,"value":1077},"approve",{"type":854,"value":1079}," of a request",{"type":849,"tag":917,"props":1081,"children":1082},{},[1083],{"type":854,"value":1084},"10",{"type":849,"tag":917,"props":1086,"children":1087},{},[1088],{"type":854,"value":542},{"type":849,"tag":917,"props":1090,"children":1091},{},[1092],{"type":854,"value":1093},"approver, request, change check, agent's user, request again, row, membership, the patch's read; request (twice), row, activity",{"type":849,"tag":857,"props":1095,"children":1097},{"id":1096},"the-session-check",[1098],{"type":854,"value":1099},"The session check",{"type":849,"tag":850,"props":1101,"children":1102},{},[1103,1105,1110],{"type":854,"value":1104},"A person's call first checks the Better Auth session: 2 more reads in the\nauth component. In ",{"type":849,"tag":869,"props":1106,"children":1107},{},[1108],{"type":854,"value":1109},"starters\u002Fmcp-oauth-agent",{"type":854,"value":1111},", a page of three projects reads\n8 documents and renaming one project reads 6 and writes 1.",{"type":849,"tag":850,"props":1113,"children":1114},{},[1115],{"type":854,"value":1116},"An agent's call through the MCP door checks the live grant instead: the\nsession, the client, the resource link and the consent, 6 documents in the\nauth component, about 27 ms when nothing is cached. The library checks the\ngrant once per call, also in reads. A revoked connection fails at its next\ncall.",{"type":849,"tag":850,"props":1118,"children":1119},{},[1120,1122,1126,1128,1133],{"type":854,"value":1121},"Measured live on a Convex deployment, the totals match: a page of three\nprojects read 8 documents (6 + 2), and a tool call with a ",{"type":849,"tag":869,"props":1123,"children":1124},{},[1125],{"type":854,"value":1004},{"type":854,"value":1127}," read 9\nand wrote 3 (3 + 6 for the grant). In ",{"type":849,"tag":869,"props":1129,"children":1130},{},[1131],{"type":854,"value":1132},"convex-test",{"type":854,"value":1134}," with the real auth\ncomponent, a tool call that asks a person reads 10 documents and writes 2:\n4 + 6 for the grant. The summary function's reads of rows the call already\nread are free.",{"type":849,"tag":857,"props":1136,"children":1138},{"id":1137},"what-one-active-user-costs",[1139],{"type":854,"value":1140},"What one active user costs",{"type":849,"tag":850,"props":1142,"children":1143},{},[1144],{"type":854,"value":1145},"An example, priced at Convex's Professional plan on 2026-10-07. The cost of\neach call is measured on a deployment; the usage pattern is an assumption: one\nperson on a team who manages projects and uses an AI assistant, on 22 working\ndays a month.",{"type":849,"tag":877,"props":1147,"children":1148},{},[1149,1170],{"type":849,"tag":881,"props":1150,"children":1151},{},[1152],{"type":849,"tag":885,"props":1153,"children":1154},{},[1155,1160,1165],{"type":849,"tag":889,"props":1156,"children":1157},{},[1158],{"type":854,"value":1159},"Per working day",{"type":849,"tag":889,"props":1161,"children":1162},{},[1163],{"type":854,"value":1164},"Count",{"type":849,"tag":889,"props":1166,"children":1167},{},[1168],{"type":854,"value":1169},"Function calls",{"type":849,"tag":910,"props":1171,"children":1172},{},[1173,1190,1207,1224,1242,1260],{"type":849,"tag":885,"props":1174,"children":1175},{},[1176,1181,1185],{"type":849,"tag":917,"props":1177,"children":1178},{},[1179],{"type":854,"value":1180},"Opens or reloads the app (6 live queries)",{"type":849,"tag":917,"props":1182,"children":1183},{},[1184],{"type":854,"value":1084},{"type":849,"tag":917,"props":1186,"children":1187},{},[1188],{"type":854,"value":1189},"60",{"type":849,"tag":885,"props":1191,"children":1192},{},[1193,1198,1203],{"type":849,"tag":917,"props":1194,"children":1195},{},[1196],{"type":854,"value":1197},"Live updates when teammates change something",{"type":849,"tag":917,"props":1199,"children":1200},{},[1201],{"type":854,"value":1202},"~60 re-runs",{"type":849,"tag":917,"props":1204,"children":1205},{},[1206],{"type":854,"value":1189},{"type":849,"tag":885,"props":1208,"children":1209},{},[1210,1215,1220],{"type":849,"tag":917,"props":1211,"children":1212},{},[1213],{"type":854,"value":1214},"Own changes",{"type":849,"tag":917,"props":1216,"children":1217},{},[1218],{"type":854,"value":1219},"15",{"type":849,"tag":917,"props":1221,"children":1222},{},[1223],{"type":854,"value":1219},{"type":849,"tag":885,"props":1225,"children":1226},{},[1227,1232,1237],{"type":849,"tag":917,"props":1228,"children":1229},{},[1230],{"type":854,"value":1231},"Session refreshes (app open about 2 hours)",{"type":849,"tag":917,"props":1233,"children":1234},{},[1235],{"type":854,"value":1236},"8",{"type":849,"tag":917,"props":1238,"children":1239},{},[1240],{"type":854,"value":1241},"53",{"type":849,"tag":885,"props":1243,"children":1244},{},[1245,1250,1255],{"type":849,"tag":917,"props":1246,"children":1247},{},[1248],{"type":854,"value":1249},"Agent tool calls through MCP, grant check included",{"type":849,"tag":917,"props":1251,"children":1252},{},[1253],{"type":854,"value":1254},"20",{"type":849,"tag":917,"props":1256,"children":1257},{},[1258],{"type":854,"value":1259},"78",{"type":849,"tag":885,"props":1261,"children":1262},{},[1263,1268,1272],{"type":849,"tag":917,"props":1264,"children":1265},{},[1266],{"type":854,"value":1267},"Approvals and in-app agent runs",{"type":849,"tag":917,"props":1269,"children":1270},{},[1271],{"type":854,"value":542},{"type":849,"tag":917,"props":1273,"children":1274},{},[1275],{"type":854,"value":1276},"28",{"type":849,"tag":850,"props":1278,"children":1279},{},[1280],{"type":854,"value":1281},"That is about 6,500 function calls and 11 MB of database traffic a month, or\nabout $0.016 at the plan's overage prices. The plan's included amounts cover\nseveral thousand such users. The library's own checks are a small part of it:\na person's call reads what a hand-written secure function reads, and the\nagent's grant check adds about $0.002 a month. The model calls of an in-app\nagent are billed by the model provider and usually cost more than all of the\nConvex usage.",{"type":849,"tag":850,"props":1283,"children":1284},{},[1285,1287,1292],{"type":854,"value":1286},"Two things grow with use: live updates multiply with the number of people who\nwatch the same data, so keep queries narrow and paginate; and the activity log\ngrows until ",{"type":849,"tag":869,"props":1288,"children":1289},{},[1290],{"type":854,"value":1291},"housekeeping",{"type":854,"value":1293}," deletes rows older than a year.",{"type":849,"tag":857,"props":1295,"children":1297},{"id":1296},"keep-a-budget",[1298],{"type":854,"value":1299},"Keep a budget",{"type":849,"tag":850,"props":1301,"children":1302},{},[1303,1305,1311],{"type":854,"value":1304},"Write one budget test for each kind of call your application makes, as in\n",{"type":849,"tag":1306,"props":1307,"children":1309},"a",{"href":1308},"\u002Fdocs\u002Fbuild\u002Ffunctions\u002Ftesting#a-budget-for-each-call",[1310],{"type":854,"value":515},{"type":854,"value":1312},". The test\nfails when a change reads more, for example a lookup per row instead of one\nper call. Raise the number on purpose, and say why in the commit.",{"type":849,"tag":857,"props":1314,"children":1316},{"id":1315},"reduce-the-cost-of-your-own-operations",[1317],{"type":854,"value":1318},"Reduce the cost of your own operations",{"type":849,"tag":1320,"props":1321,"children":1322},"ul",{},[1323,1329,1334,1353],{"type":849,"tag":1324,"props":1325,"children":1326},"li",{},[1327],{"type":854,"value":1328},"Read rows by an index that starts with the field their rule checks. A\nquery cannot skip rows, so a broad query reads more and fails on the first\nforeign row.",{"type":849,"tag":1324,"props":1330,"children":1331},{},[1332],{"type":854,"value":1333},"Look up related rows once per call, not once per row.",{"type":849,"tag":1324,"props":1335,"children":1336},{},[1337,1339,1344,1346,1351],{"type":854,"value":1338},"Paginate lists. A tool for agents pages too: it gets ",{"type":849,"tag":869,"props":1340,"children":1341},{},[1342],{"type":854,"value":1343},"cursor",{"type":854,"value":1345}," and ",{"type":849,"tag":869,"props":1347,"children":1348},{},[1349],{"type":854,"value":1350},"limit",{"type":854,"value":1352},"\n(1 to 100, 50 by default) instead of Convex's pagination options.",{"type":849,"tag":1324,"props":1354,"children":1355},{},[1356,1358,1362],{"type":854,"value":1357},"Keep plans short. Every row a plan lists is fingerprinted, and ",{"type":849,"tag":869,"props":1359,"children":1360},{},[1361],{"type":854,"value":1077},{"type":854,"value":1363},"\nreads it again to check that it did not change.",{"title":1365,"searchDepth":1366,"depth":1366,"links":1367},"",4,[1368,1370,1371,1372,1373],{"id":859,"depth":1369,"text":862},2,{"id":1096,"depth":1369,"text":1099},{"id":1137,"depth":1369,"text":1140},{"id":1296,"depth":1369,"text":1299},{"id":1315,"depth":1369,"text":1318},"markdown","docs",{"source":1377,"path":1378,"stem":1379,"dir":1380,"extension":1381},"content","docs\u002F3.build\u002F8.functions\u002F6.cost.md","docs\u002F3.build\u002F8.functions\u002F6.cost","functions","md",{"requestedPath":526,"resolvedPath":526,"alternates":1383},[],{"requested":1385,"resolved":1386,"usedFallback":6},{},{"locale":8},{"previous":1388,"next":1390},{"title":515,"id":516,"canonicalKey":517,"locale":8,"draft":6,"navigation":1389,"icon":519,"path":520},{"icon":519},{"title":528,"id":529,"canonicalKey":530,"locale":8,"draft":6,"navigation":1391,"icon":532,"path":533},{"icon":532},1794905510235]