Overview
Convex provides the serverless backend for storing conversations and messages. You need to deploy your Convex functions before deploying the backend and dashboard.Prerequisites
- Convex account (sign up at convex.dev)
- Node.js 20+ installed
- Project dependencies installed (
npm install)
Deployment Steps
1. Generate Types
Generate TypeScript types from your Convex schema:convex codegen and creates type definitions used by the backend and dashboard.
2. Deploy to Convex Cloud
Deploy your Convex functions and schema:- Creates a production deployment on Convex Cloud
- Deploys all functions from the
convex/directory - Applies the database schema
- Returns your production
CONVEX_URL
3. Note Your CONVEX_URL
After deployment, copy your productionCONVEX_URL. It will look like:
- Backend environment variables
- Dashboard environment variables
Environment Variables
Backend
Set in your backend deployment:Dashboard
Set in your dashboard deployment:Convex Schema
The project includes:- conversations table - Stores chat sessions with sessionId and timestamps
- messages table - Stores individual messages linked to conversations
convex/schema.ts and automatically deployed.
Development vs Production
During development:convex dev which:
- Watches for changes and auto-deploys
- Provides a development Convex URL
- Hot-reloads functions
Verifying Deployment
After deployment:- Check the Convex dashboard at dashboard.convex.dev
- Verify your functions are listed
- Check that tables are created
- Test queries using the dashboard’s query console
Next Steps
After deploying Convex:- Deploy the backend with your
CONVEX_URL - Deploy the dashboard (optional)