https://github.com/hariharen9/spendwiser

SpendWiser 🚀: Your Ultimate Financial Command Center for effortless expense tracking, intelligent budgeting, financial goal setting, and insightful analytics.
https://github.com/hariharen9/spendwiser

budgeting expense-tracker finance firebase money-management personal-finance pwa react tailwind-css typescript

Last synced: 2 months ago
JSON representation

SpendWiser 🚀: Your Ultimate Financial Command Center for effortless expense tracking, intelligent budgeting, financial goal setting, and insightful analytics.

Host: GitHub
URL: https://github.com/hariharen9/spendwiser
Owner: hariharen9
License: other
Created: 2025-09-10T13:13:44.000Z (10 months ago)
Default Branch: main
Last Pushed: 2026-04-05T07:55:09.000Z (3 months ago)
Last Synced: 2026-04-05T09:22:21.513Z (3 months ago)
Topics: budgeting, expense-tracker, finance, firebase, money-management, personal-finance, pwa, react, tailwind-css, typescript
Language: TypeScript
Homepage: https://spenditwiser.netlify.app/
Size: 7.26 MB
Stars: 1
Watchers: 0
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

💸 SpendWiser

Your Ultimate Financial Command Center

From financial chaos to crystal clarity.

---

## 🌟 Why SpendWiser Will Revolutionize Your Finances

> *"SpendWiser isn't just an expense tracker. It's a complete financial command center that empowers you with the clarity and tools needed to master your money."*

---

## 🏆 Core Features

### 💰 **Effortless Tracking & Goals**
**Automate, Track, and Achieve**
- **Zero-Touch SMS Automation:** Sync your bank alerts automatically with our companion Android app.
- **Effortless Expense Tracking:** Log every transaction with ease and intuitiveness. Categorize, tag, and add descriptions for a complete picture of your spending.
- **Automate Your Finances:** Set up **Recurring Transactions** for bills and subscriptions and never manually enter them again.
- **Turn Dreams into Reality:** Create **Financial Goals** and track your progress towards your next big purchase, vacation, or investment.
- **All Accounts in One Place:** Manage checking, savings, and credit card accounts seamlessly.
- **Easy Data Migration:** Full CSV import/export and secure JSON backup/restore.

### 🚀 **Financial Strategy & Analytics**
**Become Debt-Free Faster & Plan for the Future**
- **Loan Repayment Simulator:** Our interactive EMI calculator is a strategic tool to conquer debt. Model prepayments and extra EMIs to see exactly how much interest you'll save and how much sooner you can be debt-free.
- **At-a-Glance Command Center:** A fully customizable dashboard gives you a complete overview of your financial health.
- **Predict the Future:** See your projected cash flow and account balances to make smarter decisions.
- **Insightful Analytics:** Dive deep into your spending patterns with interactive charts and graphs.
- **Customizable Reports:** Generate detailed reports tailored to your needs.

### 🎯 **Intelligent Budgeting**
**Plan and Monitor with Precision**
- **Take Full Control:** Set category-based budgets or an overall monthly limit.
- **Stay on Track:** Visual progress bars and spending alerts notify you before you overspend.
- **Real-Time Clarity:** See your spending update instantly as you add transactions.
- **Smart Categorization:** Automatically categorize transactions with AI-powered suggestions.

### ✨ **A Modern UI You'll Love**
**An Experience Designed for Clarity & Speed**
- **Beautifully Responsive:** A seamless experience on desktop, tablet, and mobile.
- **Deeply Customizable:** Automatic Dark/Light mode and multiple font choices to fit your style.
- **Fluid & Fast:** Smooth animations and custom-built components make managing finances a pleasure, not a chore.
- **Intuitive Navigation:** A clean, user-friendly interface with easy-to-understand controls.

## 🤖 Zero-Touch SMS Automation (The SpendWiser Listener)

Forget manual entry. Your financial dashboard should build itself.

We've engineered a decoupled, **serverless** background pipeline that intercepts your bank SMS alerts the *exact moment* they hit your phone, and instantly drafts them into your SpendWiser dashboard.

- **100% Free & Open:** By sideloading our open-source companion app natively on Android, we completely bypass expensive bank API aggregators (like Plaid) and restrictive app store policies.
- **AI Parsing with BYOK:** Bring your own [Google Gemini API key](https://aistudio.google.com/apikey) for instant, intelligent SMS parsing. Your key lives in your private Firebase vault — never on our servers. No key? No problem — the pipeline falls back to a smart Regex engine automatically.
- **3-Tier Resilient Parsing:** Every SMS runs through a cascading fallback engine: `gemini-3.1-flash-lite-preview` → `gemini-2.5-flash` → Enhanced Regex Parser. Something always works.
- **Strict Privacy Focus:** Say goodbye to shady apps that sync your entire inbox to third parties. You generate your own UUID API keys, you control the open-source pipeline, and data goes directly to your private Firebase vault.
- **Real-Time Integration:** A beautifully animated, non-intrusive banner appears over your SpendWiser dashboard instantly. One click on "Review & Add" pre-fills the entire transaction modal for you!

👉 **[View & Download the Android Companion App Here](https://github.com/hariharen9/spendwiser-listener)**

💡 Why this is a clever "Technical Loophole" (The Best Way to Automate)

SpendWiser's approach is a deliberate architectural choice to solve the "SMS-to-Web" problem without corporate bloat or privacy compromises:

- **Bypassing Expensive Middlemen:** Traditional apps use aggregators like **Plaid or Yodlee**, which are costly and require you to hand over your bank login credentials to a third party. SpendWiser simply listens to the alerts your bank is *already* sending you.
- **The "Native Bridge":** Modern browsers (PWAs) are strictly prohibited from reading SMS for security. Native apps on the Play Store are also heavily restricted. By providing a **standalone, open-source Android Listener** for sideloading, we bridge this gap cleanly and legally.
- **Total Transparency:** Because the Listener app is open-source and the Netlify Parser is your own serverless function, you have 100% visibility into where your data goes. No black boxes.
- **Cost-Free Scalability:** This entire pipeline runs on free-tier serverless functions and your own device. No monthly API fees for the user.

In short: It provides enterprise-level automation with total user sovereignty.

*(Developers: Read the full architectural specs in [`sms-automation-spec.md`](./sms-automation-spec.md) and [`companion-app-spec.md`](./companion-app-spec.md)).*

---

## 📸 Featured

Unified Dashboard

SpendWiser Dashboard

Transaction Management

Transactions Page

Loan Repayment Simulator

Intelligent Budgeting

Budgets Page

Financial Goals

Financial Goals Page

Deep Customization

Settings Page

## 📱 Mobile First Experience

SpendWiser is designed from the ground up to be a pleasure to use on any device. The mobile interface is clean, fast, and provides access to all the powerful features of the desktop app.

Mobile Dashboard

Mobile Transactions

Transactions Log

Mobile Credit Cards

Mobile Loans

Mobile Settings

Mobile Login

Mobile Footer

Mobile Budgets

---

## 📈 Competitive Advantage

---
## ⭐ Why Star This Repository?
If you find SpendWiser useful, please consider giving it a star! It's a simple way to show your appreciation and helps the project gain visibility in the community. More stars mean more contributors and a better tool for everyone. Thank you for your support!

---

## 🔧 Built with Modern Excellence

SpendWiser is built with a focus on performance, real-time data synchronization, and a beautiful, accessible user experience.

---

⚡ Quick Start (For Developers)

1. **Clone the repository:**
```bash
git clone https://github.com/hariharen9/spendwiser.git
cd spendwiser/
```

2. **Install dependencies:**
```bash
npm install
```

3. **Configure Firebase:**
* Create a `.env` file in the root directory (`cp .env.example .env`).
* Add your Firebase project configuration keys to the `.env` file.

4. **Launch the app:**
```bash
npm run dev
```

---
## 📜 License

The source code for SpendWiser is available under the [PolyForm Noncommercial License 1.0.0](https://github.com/hariharen9/spendwiser/blob/main/LICENSE).

**What this means:**
- **You are free to:** View, download, modify, and run the code for your own **personal, non-commercial use**.
- **You are NOT allowed to:** Use this software for any commercial purpose, re-sell it, or include it in a commercial product without a separate commercial license from the author.
- **You must:** Include the original copyright notice and license in all copies or substantial portions of the software.

---

If you find my work helpful, consider supporting me!