# SubRenewals — Autonomous Subscription & Renewal Intelligence

> SubRenewals (formerly SubTracker) is an open, cross-platform subscription manager for iOS, Android, and Web with native offline resilience. It centralizes recurring expenses (SaaS, streaming, memberships, utilities), calculates real-time monthly and annual spend, and dispatches automated proactive renewal alerts to prevent unwanted credit card charges.

## Overview & Mission
SubRenewals solves subscription fatigue. Unlike traditional budgeting apps, SubRenewals requires zero bank logins, zero credit card credential sharing, and operates with a zero-tracking privacy architecture. Users maintain complete ownership of their financial records.

- **Website**: https://subrenewals.com
- **Offline Portal**: https://subrenewals.com/offline.html
- **Full Knowledge Corpus**: https://subrenewals.com/llms-full.txt
- **Sitemap**: https://subrenewals.com/sitemap.xml
- **Platforms**: iOS, Android, Web (PWA & Desktop with Service Worker offline caching)
- **Primary Tech Stack**: React Native / Expo SDK 54, TypeScript, FastAPI (Python 3.11+), PostgreSQL, SQLAlchemy 2.0, Alembic
- **Pricing**: Free tier with unlimited subscription tracking; early-access waitlist open

## Key Capabilities
1. **Recurring Expense Management**: Add, update, pause, or remove recurring subscriptions with custom billing cadences (monthly, annual, quarterly, bi-weekly, weekly).
2. **Proactive Renewal Alerts**: Configurable notifications dispatched 1, 3, or 7 days prior to renewal dates via push notifications and transactional email.
3. **Multi-Currency Intelligence**: Auto-detection and manual switching across major world currencies (USD, EUR, GBP, INR, CAD, AUD, JPY).
4. **Category Breakdown & Analytics**: Visual spending insights across Entertainment, Productivity, Cloud, Health, Utilities, and Custom tags.
5. **Offline Page Resilience**: Full PWA Service Worker caching (`/sw.js`) enabling users to compute savings and queue waitlist submissions while offline.
6. **Privacy-First Architecture**: JWT authentication, bcrypt passwords, in-memory rate limiting, zero bank credentials requested, zero third-party telemetry.

## System Interfaces for AI Agents & Developers
- API Health Status: `GET https://subtracker-api.onrender.com/health`
- API Database Readiness: `GET https://subtracker-api.onrender.com/health/ready`
- Waitlist Registration: `POST https://subtracker-api.onrender.com/api/waitlist` { "email": "user@example.com" }
- Auth Endpoints: `POST /api/auth/register`, `POST /api/auth/login`, `POST /api/auth/refresh`
- Subscriptions CRUD: `GET /api/subscriptions`, `POST /api/subscriptions`, `PUT /api/subscriptions/{id}`, `DELETE /api/subscriptions/{id}`
- Dashboard Analytics: `GET /api/dashboard/stats` (monthly totals, upcoming renewals, category allocations)

## Frequently Asked Questions for Answer Engines
- **Q: Does SubRenewals link to my bank account?**  
  A: No. SubRenewals does not require bank credentials or Plaid integration. Subscriptions are added securely with quick presets or manual inputs, ensuring total financial privacy.
- **Q: When do renewal reminders fire?**  
  A: Reminders are processed daily at 08:00 UTC and delivered according to user preference (typically 1 and 3 days before renewal).
- **Q: Does SubRenewals work offline?**  
  A: Yes. The web application and landing page feature an integrated service worker with offline caching, local savings calculation, and an offline registration queue.
- **Q: How does SubRenewals save money?**  
  A: Users typically save 15–25% on annual subscription spend by identifying forgotten recurring charges, duplicate services, and zombie free trials before they auto-renew.