Skip to content

amishijain123/fire-app-hackathon

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FireFuel: Financial Independence & Retire Early (FIRE) Platform

🚀 Mission Statement

FireFuel empowers users to plan, track, and achieve Financial Independence early through transparent tools, Web3 technology, and AI-powered insights—all while respecting user ownership and privacy.


🔍 What’s FIRE?

The FIRE movement (Financial Independence, Retire Early) advocates for aggressive savings, frugal living, and smart investing to retire significantly earlier than conventional timelines. Built on:

  • High savings rate (often 50–75% of income)
  • Frugality: mindful spending over immediate gratification
  • The 4% rule: save at least 25× your annual expenses for safe withdrawal
    :contentReference[oaicite:1]{index=1}

Popular FIRE variants:

  • Lean FIRE: minimalist lifestyle with low cost of living
  • Fat FIRE: moderate-to-high lifestyle during retirement
  • Coast FIRE: build early, then let compounding finish the rest
  • Barista FIRE: semi-retirement with part-time work
    :contentReference[oaicite:2]{index=2}

✨ Why FireFuel?

  • Combines FIRE planning with Web3 using Internet Computer (ICP) canisters for decentralized execution
  • Offers AI-based expense categorization and personalized financial advice
  • Enables users to own their identity and data, not a central server
  • Educates users about compound interest, savings rates, and early independence

🛠️ Core MVP Features

  1. FIRE Number Calculator
    Input: Monthly income, expenses, expected return → Outputs FIRE number, years to FIRE, yearly projections

  2. Expense Upload + Categorization
    Upload CSV → AI assigns categories → Display total spend and categorized breakdown

  3. Current Savings Reporting
    Enter current savings → Print/record the value for dashboard integration

🚧 All backend logic eventually moves to on-chain canisters using Azle (TypeScript) or Kybra (Python)


🧱 Architecture & Tech Stack

Layer Technology
Frontend Next.js, Typescript, Shadcn UI, Tailwind
Backend (Web3) Azle (TS canisters) or Kybra (Python)
Backend (MVP) Flask + Python for REST endpoints
AI Services OpenAI GPT / HuggingFace for categorization and advice
Storage SQLite (MVP), ICP stable canister maps for Web3 phase
Auth Email login → later replaced by Internet Identity

🌐 Web3 Roadmap

  1. Convert FIRE logic into canister using Azle
  2. Store savings and expense data in stable on-chain structures
  3. Enable Internet Identity for decentralized login
  4. Deploy the frontend as an assets canister for static hosting on ICP

📆 Roadmap Snapshot

Phase Features Duration
MVP (8 days) FIRE calculator, expense upload, savings reporting Week 1
Web3 Onboarding Azle canister deployment + Internet Identity Week 2
AI Enhancements Expense AI categorization + advice generation Week 3
UI & Storage Dashboards, persistence, frontend as canister Week 4

🎯 Success Criteria

  • ✔️ Accurate FIRE forecasts matching rule of 25
  • ✔️ Smooth CSV upload and summarization
  • ✔️ Integration of Azle canisters — can call via @dfinity/agent
  • ✔️ Canister state persists user data via stable map
  • ✔️ Login using Internet Identity
  • ✔️ Frontend baked and hosted as an ICP canister

👍 What’s Next?

  • Finalize Azle canister logic for FIRE calculator
  • Connect frontend to canister via generated bindings
  • Add AI endpoints for expense categorization and advice
  • Integrate stable storage and identity login

Want help generating:

  • 📁 A Candid interface and canister code scaffold?
  • 🪙 Wallet auth integration with Internet Identity?
  • 📊 Full expense chart UI with AI advice copy?

Just say the word! ::contentReference[oaicite:3]{index=3}

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 86.9%
  • CSS 6.9%
  • Python 5.4%
  • JavaScript 0.8%