Skip to content

nylaimanii/ripple

Repository files navigation

🌊 RIPPLE — Every Choice Has a Wave

Built for YHack Spring 2026 at Yale University | Societal Impact Track

What is Ripple?

RIPPLE is an AI-powered interactive history experience. Type any moment in history, step inside it as a key decision-maker, and watch your choices ripple across the world.

The entire point: YOUR DECISIONS MATTER. They affect the people around you. They shape the world. History proves it. Every single time.

How it works

  1. Type any historical moment (Rosa Parks, Cuban Missile Crisis, Hiroshima...)
  2. The AI drops you inside that moment as the key decision-maker
  3. Face the real choices they faced — with full consequences
  4. Watch your decisions ripple across an interactive globe
  5. Get your Ripple Score and Decision DNA profile
  6. Sign in to track your Ripple Journal and see your lifetime impact

Tech Stack

  • React + Vite
  • Groq AI (llama-3.3-70b-versatile) for scenario generation
  • Mapbox GL JS for the interactive globe
  • Supabase for the Regret Archive and user accounts
  • Framer Motion for animations
  • Web Speech API for voiceover

Tracks

  • Societal Impact (Education)
  • Best Solo Hack
  • Most Creative Hack
  • Best UI/UX

Setup

  1. Clone the repo
  2. Run npm install
  3. Create .env with your API keys (see .env.example)
  4. Run npm run dev

About

An AI-powered interactive history experience. Type any moment in history, step inside it as a key decision-maker, and watch your choices ripple across the world. Built for YHack Spring 2026 at Yale University.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages