https://github.com/ajnart/subs
Subs ! Track your subscriptions easily
https://github.com/ajnart/subs
nextjs react shadcn-ui subscriptions-tracker
Last synced: about 1 month ago
JSON representation
Subs ! Track your subscriptions easily
- Host: GitHub
- URL: https://github.com/ajnart/subs
- Owner: ajnart
- Created: 2024-10-09T11:03:27.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-05-09T10:30:10.000Z (about 2 months ago)
- Last Synced: 2025-05-11T06:14:46.164Z (about 1 month ago)
- Topics: nextjs, react, shadcn-ui, subscriptions-tracker
- Language: TypeScript
- Homepage: https://subs.ajnart.fr/
- Size: 1.96 MB
- Stars: 473
- Watchers: 3
- Forks: 27
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# Subs - Simplistic Open Source Subscription Cost Tracker
Subs is a lightweight application designed to help you track and manage your subscription costs across different services. With a clean and intuitive interface, it simplifies the process of monitoring your recurring expenses.
## Features
- **Track Subscriptions**: Add, edit, and delete subscription details including name, price, and currency
- **Automatic Favicon Fetching**: Visual identification of your subscriptions with icons from their domains
- **Multi-Currency Support**: Track subscriptions in different currencies with automatic conversion rates
- **Total Cost Calculation**: See your total monthly expenses at a glance
- **Import/Export**: Easily back up your subscription data or move it between devices
- **Client-Side Storage**: Option to store data in your browser for privacy or use SQLite for persistence
- **Responsive Design**: Works seamlessly on both desktop and mobile devices
## Demo
You can try out Subs without installing anything at [subs.ajnart.fr](https://subs.ajnart.fr)
## Tech Stack
Subs is built with modern web technologies:
- **Framework**: Remix (React)
- **Styling**: Tailwind CSS with Shadcn UI components
- **State Management**: Zustand
- **Package Manager**: Bun
## 🚀 Installation
### 🌐 Use the Online Version
Visit [subs.ajnart.fr](https://subs.ajnart.fr) to use the tool immediately without installation.
### 🐳 Run with Docker
Run with a single command:
```bash
docker run -p 7574:7574 -v ./data:/app/data --name subs --rm ghcr.io/ajnart/subs
```
Then visit `http://localhost:7574` in your browser.
### 📦 Using Docker Compose
Create a `docker-compose.yaml` file:
```yaml
services:
subs:
image: ghcr.io/ajnart/subs
container_name: subs
ports:
- "7574:7574"
restart: unless-stopped
# volumes: Optional: Uncomment to use a volume to save data outside of the default docker volume
# - ./data:/app/data
# environment:
# - USE_LOCAL_STORAGE=true # Uncomment to use browser storage instead of file storage (different config for each browser)
```
Then run:
```bash
docker-compose up -d
```
Open [http://localhost:7574](http://localhost:7574) in your browser to see the webui
> [!NOTE]
> Data is stored in the `/app/data` directory inside the container. Mount this directory as a volume to persist your data between container restarts.
## Contributing
Contributions are welcome! Feel free to open issues or submit pull requests to help improve Subs.
## License
This project is open-source and available under the MIT License.
---
Thank you for your interest in Subs! We hope it helps you keep better track of your subscription costs.