Subs - Simplistic Open Source Subscription Cost Tracker

This repo is a little special

[!NOTE] I am building my own coding assistant extension called kodu.ai, the goal is to help people build their ideas with little to no preivous coding experience. This repository comes from an idea I have had in the back of my mind for a while, I built it in less than 2 hours using Kodu and it has helped me improve the extension. I thought the idea was nice so I shared it and a lot of you liked it, so I decided to open-soure the code.

I'd love for this repo to be a collaborative effort between enthousiasts of the self-hosted community, my goal with Kodu is to enable anyone to make modifications and improvements to tools they use on a daily basis. If you would like to try to improve this repository by using an LLM/Code assistant feel free to do so, I have a lot to learn from testimonials. If you have some spare time and want to give it a try, visit the ai-tagged issues . They are issues that could be added by anyone, even someone with 0 coding experience.

Introduction

Hey everyone! Following the feedback from my previous post, I'm excited to announce that Subs Tracker is now open-source and hosted on my own website.

Demo

You can check out the demo here: subs.ajnart.fr

What's New?

• Improved UI/UX: We've given the app a facelift, making it more visually appealing and user-friendly.
• Client-Side Data Storage: Your data is now stored directly in your browser, eliminating the need for self-hosting.
• Edit Functionality: You can now easily edit your existing subscriptions.

Features

• Add, edit, and remove subscriptions
• Automatic favicon fetching for easy visual identification
• Total monthly cost calculation
• Responsive design for both desktop and mobile use

Tech Stack

For those curious about the technology behind Subs Tracker:

• Frontend Framework: Next.js and React
• UI Components: Shadcn UI
• State Management: Zustand
• Development Tools: GitHub Copilot and Kodu AI code extension

Docker setup

[!NOTE] Docker setup work in progress at the moment. Feel free to contribute to the project and help me finish it.

Development Setup / Installation

1. Clone the repository
2. Install dependencies with pnpm i (install it here)
3. Copy the example env var file with copy .env.example .env
   1. Optional: Update the SQLLite database file setting in .env
      2. Optional: Set NEXT_PUBLIC_USE_SQLITE to false to use localstorage instead of SQLLite (will persist data in the browser)
4. Push the database schema with pnpm run db:push (not needed if you are using localstorage)
5. Run the development server with pnpm run dev
6. Open http://localhost:3000 in your browser

Demo GIF

License

This project is open-source and available under the MIT License.

Thank you for your interest and support! We hope Subs Tracker helps you keep better track of your subscription costs. Happy tracking!