Engrojkeh/web-expense-tracker

Expense tracker with Firebase auth, multi-currency conversion and budget analytics — tailored for West African users (XOF/CFA) # Dépenses Bénin — Expense Tracker > A modern web app for tracking daily expenses and managing monthly budgets, tailored for West African users. ## 🔗 Live Demo **engrojkeh.github.io --- ## 📸 Screenshots | Login | Dashboard | Add Expense | |---|---|---| | | | | --- ## About Dépenses Bénin is a frontend expense tracking web application built for users in Benin and the wider West Africa region. It supports XOF (CFA Franc) as the primary currency with real-time conversion to USD, EUR, and NGN. Built with vanilla HTML, CSS, and JavaScript — no frameworks, no build tools, just clean web fundamentals. --- ## Features - 🔐 Secure email & password authentication via Firebase Auth - 💰 Monthly budget management in XOF (CFA Franc) - 🌍 Real-time multi-currency conversion — USD, EUR, NGN - 🏷️ Expense categorization with emoji indicators (Food, Transport, Energy, etc.) - 📊 Interactive doughnut charts for spending distribution (Chart.js) - 📱 Fully responsive — desktop, tablet, and mobile - 📲 MoMo Sync simulation — bulk import of MTN Mobile Money transactions --- ## Tech Stack | Layer | Technology | |---|---| | Frontend | HTML5, Vanilla JavaScript, CSS3 (Glassmorphism + CSS Grid) | | Auth & Database | Firebase Authentication + Cloud Firestore | | Data Visualization | Chart.js | | Currency Rates | ExchangeRate-API | --- ## Getting Started ### Prerequisites - A Firebase project (free Spark plan works) - Any local HTTP server (VS Code Live Server, Python, or Node) ### 1. Clone the repo ```bash git clone github.com cd web-expense-tracker ``` ### 2. Configure Firebase Replace the Firebase config object in `index.html`, `dashboard.html`, and `add-expense.html` with your own project credentials from the Firebase Console. ```javascript const firebaseConfig = { apiKey: "YOUR_API_KEY", authDomain: "YOUR_PROJECT.firebaseapp.com", projectId: "YOUR_PROJECT_ID", ... }; ``` ### 3. Set Firestore securit …