FinLit Pulse is an interactive web application designed to teach financial literacy and basic economic principles through scenario-based decision-making. Users navigate financial scenarios, make choices, and receive real-time feedback on the outcomes of their decisions. The application tracks progress and provides a summary assessment at the end of the session.

This project was built for Hackonomics™ 2026, with the goal of spreading financial awareness in a beginner-friendly and engaging format.

1. Project Overview
2. Key Features
3. Tech Stack
4. How It Works
5. Project Structure
6. Setup Instructions
7. Roadmap & Development Flow
8. UX & Interaction Notes
9. Credits

FinLit Pulse guides users through a series of financial scenarios, where each decision impacts their financial health score. Users gain insights and practical tips, learning concepts like budgeting, debt management, and economic trade-offs.

Hackonomics Goal Alignment:

• Beginner-friendly and open-ended
• Showcases real-world financial decision-making
• Engages users interactively without complex backend
• Provides a tangible output: score + personalized advice

• Scenario-based learning: Each scenario simulates financial decision-making.
• Interactive choices: Users select options that immediately display outcome, insight, and tips.
• Progress tracking: Shows scenario number and progress bar.
• Visual feedback:
  • Selected choices highlighted
  • Other options disabled after selection
• Session summary: Score, assessment, and actionable advice.
• Restart session: Allows replay and practice.
• Smooth transitions: Fade-in animations for better UX.

1. Start Session: Users begin with a “Start Session” button.
2. Scenario Presentation:
   • Displays the scenario title, context, and multiple choices.
   • Scenario number and progress bar show user progress.
3. Choice Selection:
   • User selects one option.
   • Selected button highlights, others are disabled.
   • Outcome, economic insight, and life tip are displayed.
4. Next Scenario: User clicks “Next” to proceed to the following scenario.
5. Summary:
   • At the end, a financial health summary appears with total score, assessment, and advice.
   • Option to restart the session is available.

Decision Logic:

• Each choice has a score that updates the user’s financial health.
• Decisions are stored in LocalStorage to maintain session state across reloads.

/finlit-pulse │ ├── index.html # Main HTML file with placeholders for dynamic content ├── styles.css # Styling, animations, and responsive design ├── app.js # Core logic: scenarios, scoring, transitions, and session handling └── data.js # Scenario data: title, context, choices, scores, insights, tips