davenovccexpert-convex-nextjs

---

name: davenov:cc:expert-convex-nextjs description: Provides expertise for building full-stack applications with Convex backend and Next.js frontend, including schema design, type-safe functions, authentication, server rendering, and real-time subscriptions. Use when building or debugging Convex + Next.js applications, implementing real-time features, or needing guidance on Convex Auth, preloadQuery patterns, or function design.

<quick_start> Route based on user's stated need:

• Schema/database work: Apply validator patterns and index design from references/schema-design.md
• Function authoring: Use new syntax with args/returns validators from references/function-patterns.md
• Authentication: Implement proxy.ts routing pattern from references/ssr-auth.md
• Server rendering: Use preloadQuery + usePreloadedQuery from references/ssr-auth.md
• Debugging: Check error table and verification checklist from references/debugging.md

If user's need is ambiguous, present intake menu to clarify scope. </quick_start>

<core_workflow>

1. Set up a new Convex + Next.js project
2. Add/modify Convex functions (queries, mutations, actions)
3. Design or update the database schema
4. Implement authentication with Convex Auth
5. Add server rendering with preloadQuery
6. Debug an issue
7. Something else

Wait for response before proceeding.

</core_workflow>

<success_criteria> Task is complete when:

• Schema compiles without errors (npx convex dev shows no TypeScript errors)
• All functions have explicit args and returns validators
• All queries use .withIndex() with corresponding schema indexes (no .filter())
• Document IDs use Id<"tableName"> type, not string
• Authentication flow works correctly (proxy.ts routing, ConvexAuthNextjsProvider setup)
• preloadQuery successfully eliminates loading spinners on server-rendered pages
• User can run verification checklist without failures </success_criteria>