Operations
Deployment
Production deployment checklist for Urmate and the documentation app.
Deployment
Urmate and the documentation app can be hosted separately. Keep the application domain, Circles domain, API/webhook domain, and docs domain explicit in environment variables and provider dashboards.
Urmate Deployment Checklist
- Install dependencies with the repo package manager.
- Set production environment variables.
- Run Prisma generate and migrations.
- Build the Next.js app.
- Start the app behind HTTPS.
- Configure webhook URLs for Telegram, Discord, Meta, billing, and OAuth callbacks.
- Verify auth, dashboard, XRouter, Study, Chat, and builder smoke tests.
cd /root/apps/urmate
pnpm install
pnpm prisma generate
pnpm prisma migrate deploy
pnpm build
pnpm start
Docs Deployment Checklist
cd /root/apps/docus
pnpm install
pnpm run docs:build
Deploy the generated Nuxt app using the hosting target you choose for docs, such as a Node server, static-compatible Nitro preset, or platform deployment.
Domains
| Domain | Recommended use |
|---|---|
urmate.tech | Main product and marketing. |
app.urmate.tech | Urmate app if split from marketing. |
circles.urmate.tech | Circles-only app. |
docs.urmate.tech | Urmate documentation. |
| HTTPS tunnel | Local webhook testing only. |
Production Rules
- Use HTTPS for all OAuth and webhooks.
- Do not reuse local tunnel URLs in production provider dashboards.
- Rotate credentials after public demos if tokens were exposed.
- Keep login OAuth credentials separate from Google Calendar credentials.
- Monitor webhook error logs after every deployment.