Architecture Overview
Gitmomos is built as a modern monorepo with a decoupled architecture, designed for performance, security, and seamless integration between your local environment and the cloud.
System Diagram
The core flow of data moves from your local Git repository through our secure CLI, into the cloud backend for storage, and finally to the AI engine for report generation.
Core Components
1. CLI (packages/cli)
A TypeScript-based terminal tool that extracts commit metadata and securely dispatches it to the cloud. It communicates with your local Git configuration and interacts with our secure API endpoints.
2. Cloud Backend (supabase/)
Leverages Supabase for secure Auth, Postgres database, and Edge Functions for processing. It acts as the single source of truth and manages queuing metadata for AI processing.
3. AI Engine
A dedicated pipeline using Google's Gemini Pro to analyze technical activity and generate human-readable reports. This processing happens asynchronously to ensure fast terminal response times.
4. Web Dashboard (apps/web)
A high-performance React application built with React Router v7, featuring Framer Motion animations and Recharts visualizations. It provides a real-time view of your AI-generated reports and productivity analytics.
Data Flow & Security
Gitmomos is designed with privacy as a first-class priority. We only extract and sync the necessary metadata required to generate reports:
- Commit Messages
- Commit Hashes
- Author Dates