FinEaseAI

FinEaseAI is a personal finance web app that helps users manage loans and repayments in one place. It includes an AI-powered loan-scheme recommender, an EMI calculator, loan and expense tracking, and reminders for upcoming and missed EMIs.

Features

• Authentication — email/password and Google sign-in (Firebase Auth).
• Dashboard — EMI calculator, remaining balance, outstanding balance, and recent transactions.
• AI Loan Recommender — suggests a suitable loan scheme via a Hugging Face Space (Gradio + Groq LLM).
• Loan Tracker — add loans, track EMIs paid, and see remaining amounts.
• Expenses — record and review expenses with pagination.
• Notifications — upcoming and passed EMI reminders.
• Profile — view your basic account information.

Tech stack

• React 18 + Vite
• Tailwind CSS 4 and MUI
• Firebase (Auth + Firestore)
• Recharts / Chart.js for charts
• Hugging Face Space (Gradio) backing the AI loan recommender

Getting started

Prerequisites

• Node.js 18+ and npm
• A Firebase project with Authentication (Email/Password + Google) and Cloud Firestore enabled

Setup

1. Install dependencies:

   npm install

2. Create a .env file from the example and fill in your values:

   cp .env.example .env

   See .env.example for the full list of variables:

   Variable	Description
   VITE_FIREBASE_API_KEY	Firebase web API key
   VITE_FIREBASE_AUTH_DOMAIN	Firebase auth domain
   VITE_FIREBASE_PROJECT_ID	Firebase project id
   VITE_FIREBASE_STORAGE_BUCKET	Firebase storage bucket
   VITE_FIREBASE_MESSAGING_SENDER_ID	Firebase messaging sender id
   VITE_FIREBASE_APP_ID	Firebase app id
   VITE_GRADIO_ENDPOINT	Full URL of the Hugging Face Space (e.g. https://<user>-<space>.hf.space)

3. Deploy the Firestore security rules in firestore.rules (Firebase Console → Firestore Database → Rules → paste → Publish).

4. Start the dev server:

   npm run dev

   The app runs at http://localhost:5173.

Scripts

Command	Description
npm run dev	Start the Vite dev server
npm run build	Build for production (outputs to dist/)
npm run preview	Preview the production build locally
npm run lint	Run ESLint

Security

• .env is git-ignored — never commit real credentials.
• Firestore access is restricted per-user by the rules in firestore.rules; the "test mode" default rules are not suitable for production.