Skip to content

biancacchino/wealthquest

Repository files navigation

Wealth Quest 🍁

A retro, choice-driven financial adventure where players navigate everyday spending, saving, and investing decisions to build healthy money habits.

🌟 Overview

Wealth Quest is a story-driven financial literacy game that blends a pixel-art overworld with practical money decisions. Players explore, make choices, and learn core concepts like budgeting, saving, and investing through short, engaging interactions.

✨ Key Features

  • 🗺️ Pixel-Art Overworld: Explore a retro map powered by Phaser
  • 🧾 Spending Encounters: Buy/skip choices that impact outcomes
  • 🏦 Banking Actions: Deposit, withdraw, and track transactions
  • 📈 Investing Guidance: Learn about ETFs, stocks, and bonds
  • 📚 Learning Library: Bite-sized tips on money fundamentals
  • 📊 End-of-Run Summary: Review stats and feedback

🎯 The Problem We Solved

Money decisions are everywhere, but financial concepts can feel abstract and intimidating. Wealth Quest turns real-world scenarios into approachable, game-like choices so players can build confidence and awareness through play.

🛠️ Tech Stack

Frontend:

  • Next.js (App Router)
  • React
  • TypeScript
  • CSS

Game Engine:

  • Phaser

🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm

Installation

# Install dependencies
npm install
# Run the development server
npm run dev

Visit http://localhost:3000 to see the application.

# Build for production
npm run build
npm run start

💡 How It Works

  1. Start the Journey: Enter the intro and select a character
  2. Explore the World: Navigate the overworld map
  3. Make Choices: Respond to spending encounters and events
  4. Learn & Track: Use banking, investing, and library tools
  5. Review Outcomes: Check the end-of-run summary

🏆 Achievements

  • Built a complete, playable prototype at ElleHacks 2026
  • Implemented a Phaser overworld with interactive encounters
  • Integrated banking, investing, and educational content flows
  • Shipped a Next.js + TypeScript experience end-to-end

🎓 What We Learned

  • Designing game loops that teach without overwhelming
  • Integrating Phaser into a Next.js app
  • Translating financial concepts into simple interactions
  • Building cohesive UI flows for story-driven experiences

🔮 Future Improvements

  • Expanded storylines and encounter variety
  • More character customization and progression
  • Deeper analytics and personalized feedback
  • Accessibility enhancements and localization

👥 Team

🙏 Acknowledgments

  • Thanks to ElleHacks for hosting the hackathon

Made with ❤️ at ElleHacks 2026.

About

A retro video game to teach kids about financial literacy. Built in 36hrs.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors