Skip to content

Repository files navigation

SubSense — know what you're paying for, before it renews

stack license database platform

SubSense is a subscription tracker that shows you exactly what you're paying for, when it renews, and whether you're on budget — no spreadsheets, no surprises on your bank statement.


How it works, in one sentence

Add your subscriptions once, and SubSense keeps a live dashboard of your monthly spend, upcoming renewals, and category breakdown — rolling due dates forward automatically so it's never out of date.

Features

  • Dashboard — total monthly spend, active subscriptions, month-over-month change, upcoming renewals, and a budget tracker that warns you before you go over.
  • Subscriptions — add, edit, search, sort, pause/resume, and delete, with CSV import & export.
  • Calendar — see every renewal on a monthly calendar.
  • Spending stats — category totals and a projected annual spend.
  • Multi-currency — track subscriptions in INR, USD, EUR, or GBP; totals convert automatically.
  • Light & dark mode, responsive on desktop and mobile.
  • Android app — a companion native client for on-the-go tracking.

Getting started

Requirements: Node.js 18+ and a MongoDB database (Atlas works great).

git clone https://github.com/devapragadeesh/SubSense.git
cd SubSense

# backend
cd server && npm install
cp .env.example .env   # fill in MONGO_URI and JWT_SECRET
npm run dev

# frontend, in a new terminal
cd ..
npm install
cp .env.example .env
npm run dev

Open the printed local URL, create an account, and start adding subscriptions.

A native Android client also lives in android-app/ — open it in Android Studio to run it.


Tech stack

React · Vite · Express · MongoDB · JWT auth · Kotlin (Android)


License

MIT — see LICENSE.

About

An open-source subscription tracker that helps you manage recurring payments and monitor spending with interactive analytics.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages