Skip to content

NitiPath (नीति पथ) is a behavior-driven financial literacy simulator where users practice real-life financial decisions under uncertainty. Instead of quizzes, it uses lived scenarios, consequences, and reflection to build financial resilience across diverse Indian personas.

License

Notifications You must be signed in to change notification settings

VIKAS9793/NitiPath

Repository files navigation

NitiPath Banner

NitiPath (नीति पथ)

Practice financial decisions before they cost you.

The Problem: Financial failures rarely happen due to lack of knowledge—they happen at the moment of decision, under pressure and uncertainty.

Our Vision: To help people across Bharat develop sound financial judgment by practicing real-life decisions in a safe, risk-free simulation.

Status License Tech Typescript Vite


🏆 NCFE Hackathon 2025

Participating in the NCFE Fintech Hackathon 2025.

Mission: To help people across Bharat develop sound financial judgment by practicing real-life financial decisions in a safe, consequence-driven simulation environment.


📖 Overview

NitiPath is a decision-driven financial life simulator. It helps users build real-world financial resilience through everyday financial decisions, consequences, and replay.

Vision Principle: We do not teach financial products. We train decision-making under uncertainty.

Core Features

  • Simulation-First: Experience consequences of choices (e.g., taking a loan app vs. bank loan) without real-world risk.
  • Localized Personas:
    • Farmer: Struggles with crop cycles, informal credit, and mandi prices. (Gramin Hindi)
    • Woman: Manages SHG savings, gold loans, and household budget. (Gramin Hindi)
    • Young Adult: Navigates crypto scams, credit cards, and gig work. (Casual Hindi/Hinglish)
  • Behavioral UX: No gamification scores. Consequences are felt through narrative and restricted future choices.
  • Offline-First: Fully functional PWA for rural connectivity.

🛠️ Technology Stack

  • Frontend: React 19.2, TypeScript 5.9
  • Build Tool: Vite 7.3
  • Testing: Vitest, fast-check (Property-Based Testing)
  • Styling: CSS Variables (Bharat M3 Palette)
  • PWA: vite-plugin-pwa

🏗️ Architecture

System Architecture

The core Decision-Consequence Engine is:

  • Deterministic: Same decisions → same outcomes.
  • Rule-based: Explains why a result happened.
  • Traceable: Every outcome links back to specific user choices.

🚀 Getting Started

Prerequisites

  • Node.js >= 20.0.0
  • npm >= 10.0.0

📘 See SETUP_AND_TROUBLESHOOTING.md for detailed offline setup and deployment instructions.

Installation

git clone https://github.com/VIKAS9793/NitiPath.git
cd NitiPath
npm install

Run Locally

npm run dev
# Open http://localhost:5173

Testing

npm test          # Run 270+ tests
npm run coverage  # Check code coverage

👥 Authorship

Product Lead
VIKAS SAHANI

Co-Assistant Engineers


📄 License

This project is licensed under the MIT License.


NitiPath exists to build judgment, not knowledge.
Ready for deployment and user testing.

About

NitiPath (नीति पथ) is a behavior-driven financial literacy simulator where users practice real-life financial decisions under uncertainty. Instead of quizzes, it uses lived scenarios, consequences, and reflection to build financial resilience across diverse Indian personas.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published