Skip to content

Sumit01-tech/Financial-Time-Machine-Application

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Financial Time Machine

Welcome to Financial Time Machine โ€“ a smart way to visualize your future finances using AI-driven predictions. Designed to empower users with personalized financial scenarios, insights, and intelligent advice.


๐Ÿ“Œ Project Overview

Financial Time Machine allows users to simulate "what-if" financial scenarios and analyze future trends. Whether you're planning for a big purchase, investments, or just curious about how your current lifestyle may impact your future savings, this tool helps visualize it in a meaningful way.

Inspired by real-world financial planning needs and backed by predictive logic, this app aims to make future finances less of a mystery and more of a choice.


โœจ Key Features

  • ๐Ÿ”ฎ What-If Scenarios โ€“ Simulate possible future outcomes based on your income, expenses, and investment strategies.
  • ๐Ÿ“Š Analytics Dashboard โ€“ Visual representation of financial projections and behavior trends.
  • ๐Ÿง  AI Financial Advisor โ€“ Smart suggestions based on user input and financial patterns.
  • ๐Ÿ” Privacy First โ€“ No sensitive data is stored; everything runs locally on your machine.
  • ๐Ÿ“ฑ Responsive UI โ€“ Clean, user-friendly design built using Chakra UI.

๐Ÿ› ๏ธ Tech Stack

Category Tools Used
Frontend React, Vite
UI Framework Chakra UI
Routing React Router
Charting (Optional) Recharts / Chart.js (if added later)
State Handling useState, useEffect, useMemo, React.memo
Development Tools VSCode, Git, GitHub

๐Ÿ“‚ Folder Structure

financial-time-machine/
โ”œโ”€โ”€ public/
โ”‚   โ””โ”€โ”€ index.html
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ assets/
โ”‚   โ”‚   โ””โ”€โ”€ logo.png
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ Header.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ Footer.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ FinancialProjectionChart.jsx
โ”‚   โ”‚   โ””โ”€โ”€ FinancialCard.jsx
โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ”œโ”€โ”€ Home.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ Scenarios.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ Analytics.jsx
โ”‚   โ”‚   โ”œโ”€โ”€ Advisor.jsx
โ”‚   โ”‚   โ””โ”€โ”€ NotFound.jsx
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ”‚   โ””โ”€โ”€ calculations.js
โ”‚   โ”œโ”€โ”€ App.jsx
โ”‚   โ”œโ”€โ”€ main.jsx
โ”‚   โ””โ”€โ”€ theme.js
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ vite.config.js
โ””โ”€โ”€ README.md

๐Ÿง‘โ€๐Ÿ’ป Setup Instructions

Follow the steps below to run the app locally:

# 1. Clone the repository
git clone https://github.com/Sumit01-tech/financial-time-machine.git

# 2. Navigate into the folder
cd financial-time-machine

# 3. Install dependencies
npm install

# 4. Start the development server
npm run dev

App will be live at http://localhost:5174 (or similar port)


๐Ÿ”— Deployment Link

Live Version: https://financial-time-machine-application-24zn.vercel.app


๐ŸŽฅ Video Presentation

(https://drive.google.com/file/d/1xzcDvv60teJxBQcHezIvzE7kYvLTZ-l8/view?usp=sharing)

(Hosted on Google Drive)


โœ… Final Checklist

  • GitHub repo with clean code
  • README with setup, features, and tech stack
  • Public video presentation link
  • Deployed link added in README
  • All links tested in incognito mode
  • Team members mentioned in presentation (if needed)

๐Ÿ‘จโ€๐Ÿ’ป Team Members

Name Role
Sumit Gourav Solo Developer ๐Ÿง‘โ€๐Ÿ’ป

This project was built entirely by Sumit Gourav as a solo effort.


๐Ÿ License

This project is open source and available under the MIT License.

About

Financial Time Machine is an interactive personal finance tool that visualizes future financial outcomes based on your current decisions.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published