Skip to content

Can you predict how history unfolded? A daily puzzle game that tests causal reasoning, not trivia memorization.

Notifications You must be signed in to change notification settings

KateCatlin/Ripple-Game

Repository files navigation

🌊 Ripple

A daily cause-and-effect prediction game that tests how well you understand how the world works.

Play NowReport BugRequest Feature


About

Most trivia games test static knowledge—"What year did X happen?"

Ripple is different. It tests causal reasoning.

You're shown a real historical event and asked to predict what happened next. Get it right, and you follow the chain deeper—3 events total, each consequence leading to the next.

Ripple #728 🌊
Event 1: ✅
Event 2: ❌
Event 3: ✅
Chain Score: 2/3

It's not about memorizing dates. It's about understanding how decisions ripple through history—how consumers react, how companies pivot, how one invention enables another.

New puzzle every day. Same puzzle for everyone.


Screenshots

Gameplay Correct Answer How to Play
Gameplay Correct Answer How to Play

Tech Stack

  • Framework: React + TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS
  • Components: shadcn/ui
  • Hosting: Vercel

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repo
git clone https://github.com/yourusername/ripple.git

# Navigate to project directory
cd ripple

# Install dependencies
npm install

# Start development server
npm run dev

The app will be running at http://localhost:5173

Build for Production

npm run build
npm run preview

Contributing

Contributions are what make the open source community great. Any contributions you make are greatly appreciated.

Ways to Contribute

  • 🧩 Submit puzzle chains — We always need quality content
  • 🐛 Report bugs — Found something broken? Let us know
  • Suggest features — Have an idea? Open an issue
  • 🔧 Submit PRs — Code improvements welcome

Submitting Puzzle Chains

We're especially looking for well-researched chains in these categories:

  • Business case studies
  • Scientific discoveries
  • Tech product launches
  • Political events
  • Cultural moments

See CONTRIBUTING.md for the puzzle submission format.

Development Workflow

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Puzzle Content Guidelines

Good Ripple chains should:

  • ✅ Be historically accurate and verifiable
  • ✅ Have surprising but logical cause-and-effect connections
  • ✅ Include plausible wrong answers (not obviously fake)
  • ✅ Teach something interesting even when you guess wrong
  • ✅ Span 3-4 events in the chain

Roadmap

  • Core gameplay loop
  • Daily puzzle system
  • Share results
  • Statistics tracking
  • Difficulty modes
  • Multiplayer/challenge friends
  • Puzzle archive for past days
  • User-submitted puzzle voting

See the open issues for a full list of proposed features.


License

Distributed under the MIT License. See LICENSE for more information.

About

Can you predict how history unfolded? A daily puzzle game that tests causal reasoning, not trivia memorization.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages