Skip to content

dh1011/subscription-manager

Repository files navigation

📅 Subscription Manager

Docker Ko-fi

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 or Gotify. 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 and Gotify
  • 💱 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 and Gotify for sending notifications. To set up notifications:

  1. Go to the Settings page
  2. Choose NTFY or Gotify
  3. Enter your NTFY topic and domain, or your Gotify server URL and application token
  4. 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

Packages

 
 
 

Contributors