Skip to main content

Right Events Documentation

Right Events is an AI-powered event operations platform focused on event discovery, ticketing, organizer tooling, display picture campaigns, check-in, and post-purchase engagement for the Nigerian market.

This documentation covers two things:

  • how the product works
  • how this repository is organized, developed, and deployed

What lives in this repo​

  • A Next.js 16 web app in app/ and components/
  • A Convex backend in convex/
  • A FastAPI service in backend/ for selected backend integrations
  • A mobile gateway and typed mobile client in app/api/mobile/backend and mobile/
  • A standalone Docusaurus documentation site in docs-site/

Documentation map​

  • Getting Started: local setup, environment variables, Railway deployment
  • Product: audience, features, and workflows
  • Architecture: frontend, backend, and data model structure
  • Platform Modules: auth, payments, DP workflows, mobile gateway, AI
  • API and Integrations: current HTTP surfaces, gateway behavior, webhooks
  • Operations: health checks, releases, support, and campaign launch prep
  • Contributing: development workflow and testing expectations

If you are new to the codebase, read these in order:

  1. Getting Started Overview
  2. Local Development
  3. Architecture Overview
  4. Backend and Data

If you are deploying the docs site itself, start with Railway Deployment.