[Project] Financial Literacy Simulator #578

[MistryVishwa]

Description

Issue No : #578

Add an interactive Financial Literacy Simulator built as a modern React application. It gamifies the personal finance journey by allowing users to make budgeting, saving, and investing decisions in a risk-free virtual environment.

What was added

• Financial Literacy Simulator project in the Projects/financial-literacy-simulator directory.
• React + Vite Architecture: Implemented a "proper app" structure using React to handle the complex state management required for a continuous simulation.
• Simulation Engine:
  • Tracks time (Months & Years).
  • Automatically calculates monthly cash flow, compounding debt interest, and variable investment returns.
  • Implements a random event system (20% chance per month) for unexpected expenses (medical, car repairs) or windfalls (bonuses).
• Budget Planner: Interactive sliders for housing, food, transportation, and utilities to teach the 50/30/20 rule.
• Investment Portfolio: Simulated markets for Stocks, Real Estate, and Crypto with varying levels of risk and volatility.
• Debt Management: High-interest (Credit Card) and low-interest (Student Loan) simulators to practice debt payoff strategies.
• Financial Health Score: Dynamically scores the user's financial choices (e.g., penalties for relying on credit card debt).
• Data Persistence: Uses localStorage to save the player's progress automatically.
• Included project.json containing the author details and GitHub username (MistryVishwa).

Pre-flight checks

• I read CONTRIBUTING.md
• My folder is named in Title Case with spaces (Note: Used hyphens per maintainer instructions to avoid %20 in URLs)
• My folder contains README.md, project.json and index.html (via the React Vite template).
• My project has no console errors and no tracking scripts.

[vercel]

@MistryVishwa is attempting to deploy a commit to the SanZ's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

❌ PR Validation Failed

Your PR touches 17 files — the limit for a single project submission is 6 files.
Please remove any unrelated changes.

[github-actions]

✅ Checks Passed!

Great work, @MistryVishwa! 🎉

Your project submission passed all validation checks and will be reviewed for merging.

A thumbnail will be auto-generated for your project once this PR is merged.

[github-actions]

✅ Checks Passed!

Great work, @MistryVishwa! 🎉

Your project submission passed all validation checks and will be reviewed for merging.

A thumbnail will be auto-generated for your project once this PR is merged.

[MistryVishwa]

[github-actions]

✅ Checks Passed!

Great work, @MistryVishwa! 🎉

Your project submission passed all validation checks and will be reviewed for merging.

A thumbnail will be auto-generated for your project once this PR is merged.

[cu-sanjay]

@MistryVishwa https://github.com/cu-sanjay/Web-Dev-Projects#-projectjson-template

[github-actions]

PR Validation — All Checks Passed

@MistryVishwa, your project submission has passed all validation checks and is ready for review.

A thumbnail will be auto-generated for your project when this PR is merged.

Thank you for contributing to OpenStudio.