andrelppereira/subtracker repository overview

⁠SubTracker

Full-stack subscription management app with Flutter web frontend and .NET 10 API.

⁠Features

• Subscription tracking with categories, billing cycles, and multi-currency (EUR/USD/GBP)
• Monthly/yearly spending overview with currency conversion (Frankfurter API)
• Analytics dashboard with spending by category, monthly trends, and KPI cards
• Permanent navigation: NavigationBar (mobile) + NavigationRail (desktop)
• API key authentication (optional)
• Push notifications via Pushover
• Search, filter, sort, and swipe actions
• Dark/light mode (Material 3)
• Export/import subscriptions as JSON

⁠Quick Start

docker run -d \
  -p 80:80 \
  -v subtracker-data:/data \
  -e ConnectionStrings__Default="Data Source=/data/subtracker.db" \
  andrelppereira/subtracker:latest

Open http://localhost to access the app.

⁠With API Key Authentication

docker run -d \
  -p 80:80 \
  -v subtracker-data:/data \
  -e ConnectionStrings__Default="Data Source=/data/subtracker.db" \
  -e ApiKey=your-secret-api-key \
  -e SUBTRACKER_API_KEY=your-secret-api-key \
  andrelppereira/subtracker:latest

⁠With Pushover Notifications

docker run -d \
  -p 80:80 \
  -v subtracker-data:/data \
  -e ConnectionStrings__Default="Data Source=/data/subtracker.db" \
  -e Pushover__ApiToken=your_token \
  -e Pushover__UserKey=your_key \
  andrelppereira/subtracker:latest

⁠Environment Variables

⁠Ports

⁠Endpoints

• / — Flutter web app
• /api/subscriptions — REST API
• /api/exchange-rates — Exchange rates
• /api/settings — User settings
• /swagger — API documentation
• /health — Health check

⁠Links

• GitHub Repository⁠
• API-only image⁠

⁠License

MIT