Subsight 🎯 Subscription Tracker

A modern subscription tracking app that helps you manage recurring payments with AI-powered insights (powered by Groq).

✨ Features

• 📊 Interactive Dashboard – Real-time spending charts, KPI metrics, and analytics
• 🤖 AI Assistant – Auto-fill subscription details using Groq AI (requires your own free API key)
• 🎭 Simulation Mode – Preview budget changes by toggling subscriptions on/off
• 🔄 Multi-Format Export – Export to JSON, CSV, and PDF with one click
• 🔍 Search & Filter – Find subscriptions by name, category, or status
• ⌨️ Keyboard Shortcuts – Power user shortcuts (Ctrl+E, Ctrl+S, Ctrl+P, Ctrl+R, Ctrl+A)
• 📈 Advanced Analytics – Monthly/annual spending trends and category breakdowns
• 🔒 Supabase Authentication – Secure user authentication and data storage
• 📱 Fully Responsive – Works seamlessly on desktop, tablet, and mobile
• 🎯 Smart KPI Metrics – Track total spending, active subscriptions, and renewal dates

🚀 Quick Start

# Clone the repository
git clone https://github.com/MuhammadTanveerAbbas/Subsight-Tracker.git
cd Subsight-Tracker

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Add your GROQ_API_KEY and Supabase credentials to .env.local

# Start development server
npm run dev

Visit http://localhost:3000 to start tracking your subscriptions.

🔑 Environment Setup

Create a .env.local file with:

# Groq API Key (optional - for AI features)
GROQ_API_KEY=your_groq_api_key

# Supabase Configuration (required)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

Get API keys:

• Groq Console - Free Groq API key (optional, for AI features)
• Supabase - Free database and authentication (required)

Important: After setting up Supabase, run the SQL commands from supabase-setup.sql in your Supabase SQL editor to create the required tables.

🛠️ Tech Stack

• Framework: Next.js 15 with React 18
• Language: TypeScript
• Styling: Tailwind CSS + ShadCN UI
• Database: Supabase (PostgreSQL)
• Authentication: Supabase Auth
• AI: Groq (Llama 3.3 70B)
• Charts: Recharts
• Forms: React Hook Form + Zod validation

⌨️ Keyboard Shortcuts

• Ctrl+E - Export to JSON
• Ctrl+S - Export to CSV
• Ctrl+P - Export to PDF
• Ctrl+R - Reset simulation
• Ctrl+A - Add subscription (navigate to add form)

🔒 Data Storage & Privacy

• Account Required - You must create an account to use Subsight
• Supabase Backend - All subscription data is stored in your Supabase database
• Authentication - Secure authentication via Supabase Auth
• Your Data - Data is tied to your account and protected by Supabase's security
• Open Source - Fully transparent codebase - you can see exactly how your data is handled

🚫 What Subsight Cannot Do

We believe in transparency. Here are the current limitations:

• ❌ No Bank Integration - Cannot automatically detect subscriptions from your bank account
• ❌ No Auto Cancellation - Cannot cancel subscriptions for you
• ❌ Groq API Key Required - You need to provide your own Groq API key for AI features (free tier available at console.groq.com)
• ❌ Requires Supabase - You must set up your own Supabase project to use this app
• ❌ No Mobile App - Currently web-only (responsive design works on mobile browsers)

📝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ by Muhammad Tanveer Abbas

Live Demo: https://subsight-tracker.vercel.app

GitHub: https://github.com/MuhammadTanveerAbbas/Subsight-Tracker

100% Free • Open Source • Self-Hosted