Skip to main content

Getting Started

Welcome! This guide will help you get up and running with Rippler.

๐Ÿ“‹ Prerequisitesโ€‹

Before you begin, ensure you have the following installed:

For Node.js Projectsโ€‹

For Python Projectsโ€‹

For Java Projectsโ€‹

For Docker Projectsโ€‹

๐Ÿš€ Quick Startโ€‹

1. Clone the Repositoryโ€‹

git clone --recurse-submodules https://github.com/Citi-Rippler/rippler.git
cd rippler

2. Install Dependenciesโ€‹

Node.jsโ€‹

npm install

Pythonโ€‹

pip install -r requirements.txt

Java (Maven)โ€‹

mvn install

Java (Gradle)โ€‹

./gradlew build

3. Run the Projectโ€‹

Node.jsโ€‹

npm start

Pythonโ€‹

python main.py

Java (Maven)โ€‹

mvn spring-boot:run

Java (Gradle)โ€‹

./gradlew bootRun

Dockerโ€‹

docker-compose up

๐Ÿงช Running Testsโ€‹

Node.jsโ€‹

npm test

Pythonโ€‹

pytest

Java (Maven)โ€‹

mvn test

Java (Gradle)โ€‹

./gradlew test

๐Ÿ”ง Configurationโ€‹

Configuration files are located in:

  • .env - Environment variables (create from .env.example)
  • config/ - Application configuration files

๐Ÿ“š Next Stepsโ€‹

๐Ÿ†˜ Getting Helpโ€‹

If you encounter issues:

  1. Check the FAQ
  2. Search existing Issues
  3. Create a new issue with details about your problem

๐Ÿ“– Additional Resourcesโ€‹