🌊 Ripple - Micro-Impact Calculator

See how small positive actions compound into massive impact over time.

Ripple visualizes the compound effect of everyday good deeds. Plant a tree, teach someone to code, donate $5, or simply be kind—watch how these small actions ripple out to affect hundreds, thousands, or even millions of lives over time.

✨ Features

• 📈 Compound Impact Calculation - See how actions multiply over years
• 🌊 Ripple Effect Analysis - Understand secondary impacts (CO2 absorbed, meals provided, etc.)
• 👥 Human Impact Estimation - Roughly how many lives you'll touch
• ⚖️ Relatable Comparisons - "Equal to X flights offset" or "Y meals provided"
• 💡 Inspiring Facts - Random facts to motivate continued action
• 🖥️ Beautiful CLI - Colorful terminal visualization
• 🌐 Web Interface - Gorgeous browser-based calculator

🚀 Quick Start

CLI Usage

# Basic: plant 1 tree, see 10-year impact
bun run cli plant-tree

# Plant 5 trees, 25-year projection
bun run cli plant-tree 5 25

# Teach 2 people to code, see 20-year impact
bun run cli teach-code 2 20

# Quick summary (less verbose)
bun run cli donate 10 --quick

# List all available actions
bun run cli --list

# Calculate all actions at once
bun run cli --all 1 10

Web Interface

# Start the web server
bun run server

# Open http://localhost:3000 in your browser

📋 Available Actions

Action	Emoji	Description
plant-tree	🌳	Plant a tree - grows and multiplies over decades
teach-code	💻	Teach someone to code - knowledge multiplies
donate	💝	Donate $5 - compounds through effective giving
open-source	🔓	Contribute to open source - helps developers worldwide
mentor	🎓	Mentor someone - creates chains of guidance
recycle	♻️	Recycle consistently - lifetime of waste diverted
kindness	💫	Random act of kindness - spreads through networks
vote	🗳️	Vote & encourage voting - civic participation multiplies

🧮 How It Works

Each action has:

1. Base Impact - The immediate effect of one action
2. Compound Rate - How much the impact grows per year (e.g., trees seed new trees, mentees become mentors)
3. Ripple Effects - Secondary impacts (CO2 absorbed, meals provided, confidence boosted)
4. Human Impact Multiplier - Estimated number of lives touched

The calculator projects these forward, showing you the exponential growth of your good deeds.

📊 Example Output

╔════════════════════════════════════════════════════════════════╗
║      🌳  RIPPLE IMPACT CALCULATOR  🌳                          ║
╚════════════════════════════════════════════════════════════════╝

  YOUR ACTION:
  🌳 Plant a Tree × 5 actions
  ↳ One tree grows and multiplies its impact over decades

  TIME HORIZON:
  ⏱️  25 years into the future

  📈 IMPACT GROWTH OVER TIME
  Year 1   █████░░░░░░░░░░░░░░░░░░░░░░░░         5 trees equivalent
  Year 5   ███████░░░░░░░░░░░░░░░░░░░░░░         6 trees equivalent
  Year 15  █████████████░░░░░░░░░░░░░░░░        10 trees equivalent
  Year 25  █████████████████████████████        17 trees equivalent

  🌊 RIPPLE EFFECTS
  → CO2 Absorbed: 374 kg CO2/year
  → Oxygen Produced: 2,006 kg O2/year
  → Wildlife Homes: 1,360 species supported

  💡 DID YOU KNOW?
  A tree planted today will still be absorbing CO2 for your grandchildren

╔════════════════════════════════════════════════════════════════╗
║  🌟 Small actions, compounded over time, change the world. 🌟  ║
╚════════════════════════════════════════════════════════════════╝

🛠️ Development

# Install dependencies
bun install

# Run CLI in watch mode
bun run --watch src/cli.ts plant-tree

# Run web server in watch mode
bun run dev

# Type check
bun run typecheck

# Build standalone binary
bun run build

🤝 Contributing

Want to add more impact models? They're defined in src/impacts.ts. Each model needs:

• Unique ID and name
• Base impact value and unit
• Compound rate (1.0 = no growth, 1.1 = 10%/year)
• Ripple effects with multipliers
• Fun facts

📜 License

MIT - Use this to inspire positive action everywhere!

💭 Philosophy

"We are not combatants in a war, but gardeners in a garden. Our job is not to eliminate evil, but to cultivate good." — Unknown

Small actions feel insignificant in the moment. But compound them over years, decades, a lifetime—and you've changed the world. This tool exists to make that invisible impact visible.

What will you start today?

---

Built with 💙 by Aston - A public good for visualizing positive impact.