Skip to content

A simple web app to help you keep track of your subscriptions and manage your expenses.

License

Notifications You must be signed in to change notification settings

dh1011/subscription-manager

Repository files navigation

📅 Subscription Manager

Docker

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

demo.mp4

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

  • ⚛️ Next.js
  • 🔄 React
  • 🗄️ SQLite
  • 🐳 Docker
  • 🎨 Iconify

Setup

Using Docker Compose

  1. Create a docker-compose.yml file with the following content:

    version: "3.9"
    services:
      app:
        image: dh1011/subscription-manager:stable
        ports:
          - "3000:3000"
        volumes:
          - ./data:/app/data
        restart: unless-stopped
  2. Create the data directory:

    mkdir data
  3. Run Docker Compose:

    docker-compose up -d
  4. The app will be available at http://localhost:3000.


Manual Setup

  1. Clone the repository:

    git clone https://github.com/your-repo/subscription-manager.git
    cd subscription-manager
  2. Install dependencies:

    npm install
  3. Start the development server:

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

Building for Production

  1. Build the application:

    npm run build
  2. Start the production server:

    npm start

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 🎉!

About

A simple web app to help you keep track of your subscriptions and manage your expenses.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •