Skip to content

hariharen9/spendwiser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

279 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’Έ SpendWiser

Your Ultimate Financial Command Center
From financial chaos to crystal clarity.

Live Demo Android App GitHub Stars License
Repo Size Code Style: ESLint Netlify Status


🌟 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."

SpendWiser Interface

πŸ† 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 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

πŸ’‘ 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 and companion-app-spec.md).


πŸ“Έ Featured

Unified Dashboard

SpendWiser Dashboard
Transaction Management

Transactions Page
Loan Repayment Simulator

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 Dashboard
Mobile Transactions

Mobile Transactions
Transactions Log

Mobile Budgets
Mobile Credit Cards

Mobile Credit Cards
Mobile Loans

Mobile Loans
Mobile Settings

Mobile Settings
Mobile Login

Mobile Login
Mobile Footer

Mobile Footer
Mobile Budgets

Mobile Budgets

πŸ“ˆ Competitive Advantage

Feature SpendWiser Spreadsheets Other Trackers
Dashboard βœ… Fully Customizable & Interactive ❌ Manual setup ❓ Static
SMS Automation βœ… Zero-Touch (Android Companion) ❌ Manual entry 🚫 Not available
Loan Tracker/Adviser βœ… Integrated & Powerful ❌ Extremely complex ⛔️ Not available
Analytics & Forecasts βœ… Integrated & Automated ❌ Complex formulas ⛔️ Basic stats
Goal Setting βœ… Integrated & Automated ❌ Complex formulas ⛔️ Basic or not available
Credit Card Management βœ… Integrated & Automated ❌ Complex formulas 🚫 Not available
Budgeting βœ… Real-time & Visual ❌ Manual tracking βœ… Basic lists
UI/UX βœ… Modern, Responsive, Animated ❌ Utilitarian 🚫 Dated/Clunky
Mobile Experience βœ… PWA & Mobile-First ❌ Desktop only 🚫 Poor mobile

⭐ 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

React TypeScript Vite Firebase Tailwind CSS Framer Motion

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:

    git clone https://github.com/hariharen9/spendwiser.git
    cd spendwiser/
  2. Install dependencies:

    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:

    npm run dev

πŸ“œ License

Β© 2026 Hariharen. All Rights Reserved.

The source code for SpendWiser is available under the PolyForm Noncommercial License 1.0.0.

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!

Buy Me A Coffee PayPal


Ready to Master Your Finances?

Try SpendWiser


Built with ❀️ by
Hariharen

"Clarity in finance, confidence in life."

About

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

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors

Languages