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.
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.
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.
- 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.
- 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
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.
- Node.js >= 20.0.0
- npm >= 10.0.0
📘 See SETUP_AND_TROUBLESHOOTING.md for detailed offline setup and deployment instructions.
git clone https://github.com/VIKAS9793/NitiPath.git
cd NitiPath
npm installnpm run dev
# Open http://localhost:5173npm test # Run 270+ tests
npm run coverage # Check code coverageProduct Lead
VIKAS SAHANI
Co-Assistant Engineers
- 🤖 KIRO IDE AGENT (Spec Driven Development)
Defined specifications and architectural constraints. - 🧠 Google’s Antigravity (Agentic AI)
Implemented logic, localization, and testing.
This project is licensed under the MIT License.
NitiPath exists to build judgment, not knowledge.
Ready for deployment and user testing.

