Next steps
Pick what to build after the quick start, from MCP to deployment.
Your app now renders live Convex data, writes data, signs users in, and checks the user in Convex. Pick the next task.
Say who may do what
Write one policy and one row rule per table, and let every Convex function
check them. Start here builds one
operation, one rule and one tool with @lupinum/better-convex-functions and
@lupinum/better-convex-agents.
Connect ChatGPT or Claude
Let an AI assistant call your Convex functions as a signed-in user, through MCP. Follow these pages in order:
- Add MCP to your application: install
@lupinum/better-convex-agents, add the OAuth settings, and define one tool. - Connect ChatGPT and Claude: create a client for each host, connect it, and test it with MCP Inspector.
- Optional: MCP Apps shows a card for a tool result.
MCP on Convex explains how the pieces fit together.
With operations from @lupinum/better-convex-functions, use
the MCP door instead of registering tools by
hand.
Type-check and build
pnpm dev loads .env.local. nuxt build does not, so pass the file to it.
Add these scripts, as in starters/tutorial:
{
"scripts": {
"build": "nuxt build --dotenv .env.local",
"typecheck": "nuxt typecheck --dotenv .env.local && tsc -p convex --noEmit"
}
}nuxt typecheck needs vue-tsc, and nuxt.config.ts needs the Node types
for process.env:
pnpm add -D vue-tsc typescript@~5.9.3 @types/nodeKeep TypeScript at 5.9: vue-tsc 3 does not run on TypeScript 7.
On your computer, pnpm build warns about the loopback auth origin
http://localhost:3000. The warning is correct for a local build: it uses the
SITE_URL from .env.local.
On your host and in CI there is no .env.local. Set SITE_URL and the other
environment variables there instead.
Deploy
Before the first deploy of the tutorial app, add the email hook to convex/auth.ts, so codes are mailed instead of logged: Transactional auth email.
- Deployment: deploy Convex and Nuxt, set production secrets, and create the first signing key.
- Deploy to Vercel
- Upgrade to 1.0: move an application from a 1.0 beta.
- Environment variables: every variable and where it goes.
- Troubleshooting
Build more pages
- Queries and reactive arguments
- Pagination
- Mutations and optimistic updates
- Forms
- Upload files
- Error handling
Extend authentication
- Auth state and user data
- Route protection
- Backend authorization
- Social sign-in with GitHub or Google
- Better Auth plugins and which plugins are supported