A daily cause-and-effect prediction game that tests how well you understand how the world works.
Play Now • Report Bug • Request Feature
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.
| Gameplay | Correct Answer | How to Play |
|---|---|---|
![]() |
![]() |
![]() |
- Framework: React + TypeScript
- Build Tool: Vite
- Styling: Tailwind CSS
- Components: shadcn/ui
- Hosting: Vercel
- Node.js 18+
- npm or yarn
# 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 devThe app will be running at http://localhost:5173
npm run build
npm run previewContributions are what make the open source community great. Any contributions you make are greatly appreciated.
- 🧩 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
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.
- Fork the repo
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
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
- 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.
Distributed under the MIT License. See LICENSE for more information.


