Skip to content

Arthur1asdf/Compound-Effect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Compound Effect

A gamified financial lesson where your future starts NOW!


Overview

Compound Effect is a cute, interactive game that teaches players how money compounds over time. Every decision you make today affects your future wealth. The game emphasizes the principle that early investments, no matter how small, can grow exponentially when given time.

Players progress in rounds, each representing 3 months, making financial choices, seeing consequences, and learning actionable lessons about investing, saving, and spending.


Key Features

  • Gamified Learning: Engaging UI/UX with playful animations and decision-making puzzles to demonstrate financial concepts.
  • MongoDB Storage: Each run is saved so users can track progress, compare strategies, and learn from mistakes.
  • React + Vite Frontend: Fast, modern, and responsive interface.
  • GeminiAPI Feedback: Personalized suggestions on how to improve investment decisions and strategies.

Gameplay

  1. Start Your Future: Begin with an initial amount of money.
  2. Decision Rounds: Each round (3 months) presents multiple financial choices:
    • Invest in index funds or other assets
    • Save or spend
    • Take small risks for bigger rewards
  3. Watch Your Money Grow: At the end of each round, see how your choices affect your wealth.
  4. GeminiAPI Insights: Receive custom feedback on your strategy and learn how to optimize your future decisions.
  5. Repeat & Learn: Multiple playthroughs allow experimentation and reinforce the power of compounding.

Technical Stack

  • Frontend: React with Vite
  • Backend/Database: MongoDB for persistent game runs
  • AI Feedback: GeminiAPI
  • Hosting: Vercel

Installation / Running Locally

# Clone the repo
git clone https://github.com/yourusername/compound-effect.git](https://github.com/Arthur1asdf/swamphack26.git
cd compound-effect

# Install dependencies
npm install

# Start dev server
npm run dev

Gameplay

compoundeffectdemo-ezgif com-optimize