Skip to main content

Health, Releases, and Support

Health model​

The platform health route at app/api/health/route.ts aggregates:

  • Next.js app health
  • Convex health
  • optional backend health

It also reports whether major integrations are configured, including payments, notifications, AI, and the mobile gateway.

Useful health endpoints​

  • GET /api/health
  • GET {CONVEX_SITE_URL}/health
  • GET /api/mobile/backend/health
  • GET {BACKEND_URL}/health

Release ingestion​

Railway deployment metadata is ingested into Convex via /railway/deployments/ingest.

The release system stores:

  • deployment ID and environment
  • git SHA and branch
  • deployment status
  • runtime and image metadata
  • generated release notes and rollback context

Release admin tooling​

The admin release area under /admin/settings/releases is built to:

  • inspect deployment history
  • compare healthy and unhealthy deploys
  • suggest rollback paths
  • generate AI-assisted release notes

Support and escalation areas​

Support-related product areas are spread across:

  • /support
  • /admin/support
  • convex/support.ts
  • complaints, feedback, and contact message modules

For production operations, monitor:

  • /api/health
  • payment webhook success and failure rates
  • DP campaign throughput and latency
  • mobile gateway error rates
  • release ingest success after deploys