Skip to main content

Welcome to Rippler

🌊 Rippler is a comprehensive PR impact analysis tool for microservice-based systems. It performs automated impact analysis on code changes and notifies stakeholders of potential downstream effects.

What is Rippler?​

Rippler helps engineering teams understand the ripple effects of code changes across complex microservice architectures. When a PR is opened, Rippler automatically:

  • Analyzes the code changes
  • Identifies affected services and dependencies
  • Predicts downstream impacts using LLM-powered analysis
  • Notifies relevant stakeholders
  • Provides actionable insights for code review

Key Features​

  • ✅ Real-time PR impact analysis - Automated analysis on every pull request
  • ✅ Automated dependency detection - Intelligent service dependency mapping
  • ✅ LLM-powered insights - Context-aware impact predictions
  • ✅ Stakeholder notifications - Automated alerts to affected team members
  • ✅ Visual impact tracking - Clear visualization of change propagation
  • ✅ GitHub integration - Seamless workflow integration

Architecture Overview​

rippler/
├── services/                    # All microservices (as submodules)
│   ├── api-gateway/            # API Gateway with Spring Cloud Gateway
│   ├── auth-service/           # RBAC and permissions (Spring Boot)
│   ├── audit-service/          # Activity logging (Spring Boot)
│   ├── launchpad/             # Repository onboarding & webhook handler (Spring Boot)
│   ├── dependency-graph-engine/ # Graph analysis with JGraphT (Spring Boot)
│   ├── llm-service/           # LLM-based analysis (Python/FastAPI)
│   ├── discovery-server/      # Eureka service registry (Spring Boot)
│   └── rippler-ui/            # Next.js web interface (TypeScript/React)
├── shared/                     # Shared utilities and models
├── config/                     # Shared configuration
│   └── postgres/              # Database initialization scripts
├── docs/                       # Documentation
│   └── architecture/          # Architecture diagrams and documentation
├── website/                    # Documentation website
├── scripts/                    # Helper scripts
├── docker-compose.yml         # Production orchestration
├── docker-compose.dev.yml     # Development orchestration
├── docker-compose.prod.yml    # Production-specific configuration
└── Makefile                   # Build automation commands

Quick Start​

Get started with Rippler in just a few minutes:

  1. Prerequisites - What you need before starting
  2. Installation - Clone and set up the project
  3. Configuration - Configure your environment
  4. Running Rippler - Start the services

For Different Audiences​

New Users​

Contributors​

Maintainers​

Technology Stack​

Rippler is built with a modern, scalable technology stack:

  • Backend Services: Python, Node.js, Java
  • Frontend: Flutter (Web/Desktop)
  • Infrastructure: Docker, Docker Compose
  • AI/ML: LLM integration for impact analysis
  • Version Control: Git with submodules for service isolation

Need Help?​

Next Steps​

Ready to dive in? Here's what to do next:

  1. Follow the Getting Started Guide to set up your environment
  2. Explore the Architecture to understand how Rippler works
  3. Check out the Quick Reference for useful commands
  4. Start contributing by reading the Contribution Guide

Let's build better software together! 🚀