Backend & Packages Overview

Interactive map of the packages/ directory and the Convex backend codebase.

Backend & Packages Overview

This is your interactive launchpad for the packages/ directory, with a primary focus on the Convex serverless backend. Click any card to explore the documentation stubs for these systems.

---

The Monorepo Packages

packages/
├── backend/                # Convex Serverless Backend
├── config/                 # Shared TypeScript/ESLint configs
├── env/                    # Shared Environment Variables & Validation
├── telemetry/              # Cross-platform Telemetry & Logging
├── monitoring-extension/   # WXT Browser Extension (Distraction Blocker)
├── monitoring-mobile/      # React Native Mobile Monitoring
└── docs/                   # Internal documentation source

---

backend/convex/ — Convex Serverless Backend

The central nervous system of CommitT, hosted on Convex. This directory handles all database transactions, scheduled cron jobs, push notifications, and AI verification.

API Endpoints

Public-facing mutations and queries for the mobile and web clients.

Core Business Logic

Rules engines, verification handlers, and penalty orchestrators.

Database & Schema

Convex schema definitions and data access layers.

Execution & Cron Jobs

Scheduled background jobs, sagas, and time-based triggers.

AI & Computer Vision

Integration with OpenAI and custom vision models for proof verification.

Middleware & Auth

Authentication guards, rate limiting, and request validation.

Shared Lib & Types

Shared utilities, constants, and TypeScript definitions.

---

Core Packages

These packages contain code shared across the monorepo (used by the native app, the web dashboard, and the backend).

Config Package

Centralized TypeScript, Prettier, and ESLint configurations.

Env Package

Zod-validated environment variables shared across all apps.

Telemetry Package

Shared logging and metrics infrastructure.

---

Monitoring Packages

Monitoring Extension

WXT-based browser extension for desktop distraction blocking.

Monitoring Mobile

Shared React Native monitoring utilities.