Skip to content

David-Kimath1/subscription-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SubTracker - Never Miss a Subscription Payment Again

Deployment License Frontend Backend


Overview

A real-time subscription tracker that works across all your devices.
It helps you track spending, manage subscriptions, and avoid unexpected charges.


Why I Built This

We all experience situations where we forget about subscriptions or free trials that turn into paid plans.

This project was built to solve:

  • Managing subscriptions across multiple platforms
  • Unexpected renewal charges
  • Lack of visibility into monthly spending

SubTracker provides a single place to manage everything.


What Makes This Different

Most subscription trackers:

  • Require monthly payments
  • Store user data on external servers
  • Offer outdated or complex interfaces

SubTracker:

  • Free to use permanently
  • No ads or tracking
  • Full control of your data

Features

For Users

  • Email, Google, or guest authentication
  • Add subscriptions with price, billing cycle, and custom labels
  • Push notifications before billing dates
  • Monthly and yearly spending overview
  • Search, filter, and sort functionality
  • Export data anytime
  • Cross-device compatibility

For Admins

  • Real-time dashboard
  • User subscription analytics
  • Currency conversion support
  • CSV export functionality
  • Secure authentication system

Demo

Add a screenshot or GIF here


Requirements

  • Firebase account (free tier is sufficient)
  • Basic knowledge of HTML, CSS, and JavaScript
  • Web hosting platform (e.g., Vercel, Netlify, Firebase Hosting)

Getting Started

Clone the Repository

git clone https://github.com/David-Kimath1/subscription-tracker.git
cd subscription-tracker

How It Works

User Flow

  • Sign in or continue as guest
  • Add subscription details
  • View automatic spending calculations
  • Receive reminders before billing:
  • 7 days before
  • 3 days before
  • 1 day before
  • On due date
  • Edit or remove subscriptions anytime

Tech Stack

  • Frontend: HTML5, CSS3, JavaScript
  • Backend: Firebase (Authentication, Firestore, Cloud Messaging)
  • Charts: Chart.js
  • Icons: Font Awesome
  • Fonts: Google Fonts (Inter)

What Works

  • Desktop browsers (Chrome, Firefox, Safari, Edge)
  • Mobile browsers (iOS and Android)
  • Push notifications
  • Real-time data sync
  • Email/password authentication
  • Google Sign-In
  • Guest mode
  • Currency detection
  • Data export and import
  • Admin dashboard

Coming Soon

  • Monthly spending charts
  • Budget categories
  • Multi-currency support per subscription
  • Email reminder system

Troubleshooting

Notifications not working

  • Ensure HTTPS is enabled or use localhost
  • Enable notifications in browser settings
  • Chrome requires user interaction before enabling notifications

iOS notification issues

  • Add the app to the Home Screen
  • Enable notifications from app settings

Login issues

  • Enable Email/Password authentication in Firebase
  • Verify Firebase configuration keys

Contributing

  • Report bugs via issues
  • Submit improvements via pull requests

License

MIT License

Developer

Built by David Kimathi

Final Words

This project started as an idea and became a working product. It is not perfect, but it is functional, evolving, and represents continuous learning and improvement.

About

Smart subscription tracker with push notifications and multi-currency support

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors