Skip to main content

Sprout Platform Overview

Welcome to the Sprout platform documentation. This guide provides a comprehensive overview of all Sprout repositories, their architecture, and how to get started with development.

What is Sprout?​

Sprout is a multi-repository platform for event ticket pricing and inventory management. The platform consists of several interconnected services that handle data ingestion, processing, matching, and presentation.

Repository Structure​

The Sprout platform consists of 9 main repositories:

Core Services​

  • sprout_backend - Main NestJS API server and background worker
  • sprout_etl - Fastify-based ETL service for data processing
  • sprout_monitoring - Prometheus, Grafana, and Loki monitoring stack

Frontend Applications​

  • pricing_dashboard - React + TypeScript dashboard for pricing management
  • overlevered_app - React application (separate project)
  • overlevered_server - Server for overlevered app

Infrastructure & Integrations​

  • cloudflare-workers - Serverless scraping workers using Cloudflare Workers
  • skybox_token_extractor - Playwright service for VividSeats token extraction
  • prometheus - Prometheus monitoring configuration

Architecture Overview​

The Sprout platform follows a microservices architecture:

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  Pricing        │    │  Cloudflare     │    │  Skybox Token   │
│  Dashboard      │───▶│  Workers        │───▶│  Extractor      │
│  (React)        │    │  (Scraping)     │    │  (Playwright)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────────────────────────────────────────────────┐
│                    sprout_backend                            │
│              (NestJS API + Worker)                           │
└─────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────────────────────────┐
│                    sprout_etl                                │
│              (Fastify ETL Service)                            │
└─────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────────────────────────┐
│              PostgreSQL + Redis + MeiliSearch                │
└─────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────────────────────────┐
│              sprout_monitoring                               │
│         (Prometheus + Grafana + Loki)                        │
└─────────────────────────────────────────────────────────────┘

Key Technologies​

  • Backend: NestJS, Fastify, TypeScript
  • Frontend: React, TypeScript, Vite
  • Database: PostgreSQL (Prisma ORM)
  • Cache/Queue: Redis, BullMQ
  • Search: MeiliSearch
  • Monitoring: Prometheus, Grafana, Loki
  • Infrastructure: Docker, Cloudflare Workers
  • Environment Management: Doppler

Getting Started​

  1. Environment Setup - Configure your development environment
  2. Dependencies - Understand project dependencies
  3. Quick Start Guide - Get up and running quickly

Next Steps​