📅 Subscription Manager

This single-page web application lets you keep track of and manage your subscriptions. You can add, edit, delete, and view subscriptions all in one place. You can set up notifications for each subscription using NTFY. The app provides a general summary of all your subscriptions and a detailed summary for each payment account, all within a single, intuitive interface.

Demo

https://github.com/user-attachments/assets/9e7830e1-3c3c-474a-8f48-93ee8f5e440d

Features

• ➕ Add, edit, and delete subscriptions
• 🗓️ View subscriptions on a calendar
• 💰 Calculate weekly, monthly, and yearly totals
• 📊 Detailed summaries per payment account
• 🖼️ Easy to add icons for each subscription
• 🔔 Notification system integration with NTFY
• 💱 Support for multiple currencies

Tech Stack

• ⚛️ React
• 🚂 Express
• 🗄️ SQLite
• 🐳 Docker
• 🎨 Iconify

Setup

Using Official Docker Image

The easiest way to get started is by using the official Docker image:

1. Make sure you have Docker installed
2. Run the following command:

   docker run -p 3000:3000 dh1011/subscription-manager:latest

3. The app will be available at http://localhost:3000

Docker Compose

If you prefer to use Docker Compose:

1. Clone the repository
2. Make sure you have Docker and Docker Compose installed
3. Run the following command in the project root:

   docker-compose up --build

4. The app will be available at http://localhost:3000

Manual Setup

1. Clone the repository
2. Install dependencies: npm install
3. Create subscriptions.db file in the server directory
4. Run the app: npm run dev

Adding Icons

This app uses Iconify icons. To add an icon to your subscription, use the icon name from the Iconify icon library.

Notifications

The app integrates with NTFY for sending notifications. To set up notifications:

1. Go to the Settings page
2. Enter your NTFY topic
3. Save the settings

You'll receive notifications for upcoming subscription payments.

Enjoy 🎉!