SteadyRenew
English | 简体中文
Use online: steadyrenew.com
SteadyRenew is a local-first web app for tracking recurring subscriptions. It supports multiple currencies, renewal reminders, analytics, import/export, and optional cloud sync.
The app works without an account by storing data in the browser. Supabase, Stripe, Netlify Functions, and Bark notifications can be configured when you want hosted sync, payment, or server-side reminders.
https://github.com/user-attachments/assets/02de5f6c-c381-4308-a8ac-2d792a2a0846
Features
- Track subscriptions with category, amount, currency, billing period, and renewal date
- View monthly and yearly totals in a selected base currency
- Convert between CNY, USD, EUR, JPY, GBP, AUD, CAD, CHF, HKD, and SGD
- Sort and filter subscriptions by name, amount, renewal date, category, or creation date
- Manage built-in and custom categories
- Use AI capture to propose creates, updates, deletes, and batch updates from text or screenshots
- Import and export subscription data as JSON
- Review spending reports, category breakdowns, top subscriptions, and renewal patterns
- Export print-ready A4 PDF reports (current snapshot and annual spend)
- Use optional Supabase authentication and multi-device sync
- Send optional Bark push reminders for upcoming renewals
- Create optional Developer API keys for subscription CRUD automation
- Use light or dark mode on desktop and mobile
Tech Stack
- React 18
- TypeScript
- Vite
- Tailwind CSS
- i18next
- Recharts
- Supabase
- Netlify Functions
- Stripe
Getting Started
Requirements
- Node.js 22.12 or newer
- npm
Run Locally
git clone https://github.com/JerryyrreJ/subscription-management.git
cd subscription-management
npm install
npm run dev
The Vite development server runs at http://localhost:5173.
To test Netlify Functions locally, use:
npm run dev:full
This command requires the Netlify CLI.
Scripts
npm run dev # Start the Vite development server
npm run dev:full # Start Netlify local development
npm run build # Build for production
npm run preview # Preview the production build
npm run indexnow # Submit sitemap URLs to IndexNow
npm run lint # Run ESLint
npm run typecheck # Run app and Functions TypeScript checks
npm run test # Run utility tests
npm run test:functions # Run Netlify Functions tests
npm run db:verify # Reset and lint a local Supabase database
npm run check # Run typecheck, lint, tests, and build
npm run test:notifications # Test scheduled notification logic
Configuration
The core app runs without environment variables. Optional services use the following configuration:
| Service | Variables | Purpose |
|---|
| Supabase | VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY, SUPABASE_SECRET_KEY or SUPABASE_SERVICE_ROLE_KEY | Authentication, cloud sync, scheduled notification access, API keys, and AI capture quotas |
| Stripe | VITE_STRIPE_PUBLISHABLE_KEY, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_ID | Payment UI, checkout, and webhook handling |
| Public API | API_RATE_LIMIT_PER_MINUTE, API_MAX_ACTIVE_KEYS, API_FAILED_AUTH_RATE_LIMIT_PER_HOUR, API_RATE_LIMIT_RETENTION_HOURS | Optional API quota overrides |
| AI capture | OPENROUTER_API_KEY, ANTHROPIC_API_KEY, AI_PROVIDER, AI_MODEL, AI_FALLBACK_MODELS, OPENROUTER_SITE_URL, OPENROUTER_APP_TITLE, AI_FREE_MONTHLY_PARSES, AI_PREMIUM_MONTHLY_PARSES, AI_MAX_INPUT_CHARS, AI_MAX_IMAGE_BYTES, AI_MONTHLY_BUDGET_USD, AI_INPUT_USD_PER_MTOK, AI_OUTPUT_USD_PER_MTOK | Optional AI-assisted capture; leave provider keys unset to disable |
| Bark | Configured in the app | Push reminders for upcoming renewals |
| Netlify | URL is provided by Netlify | Function callbacks and scheduled reminders |
AI capture & privacy
AI capture can start from a sentence, a pasted bank/credit-card statement, or a screenshot. It can propose creates, updates, deletes, and batch updates. The app asks you to confirm or edit the proposed action before anything is saved — the AI only proposes, it never writes to your data directly.
- Optional & swappable. Set
OPENROUTER_API_KEY to enable the low-cost OpenRouter path. By default it uses google/gemini-2.5-flash-lite with google/gemini-2.5-flash as a fallback (AI_FALLBACK_MODELS). Anthropic remains available with AI_PROVIDER=anthropic + ANTHROPIC_API_KEY; leaving provider keys unset falls back to the manual form. The model and every guardrail are env-configurable (AI_MODEL, quotas, input caps, monthly budget — see .env.example), and the model call sits behind a small SubscriptionParser interface.
- Volume & cost control. Each user has a daily parse quota (free vs premium), every request caps the input size, and a workspace-wide monthly budget breaker pauses the feature once the configured spend ceiling is reached. The key stays server-side only.
- Privacy. What you paste or upload is sent once to the model provider for that single extraction. It is not stored and not logged — the server keeps only aggregate token counts (for the budget breaker) and a per-user daily counter, never the content. Screenshots are downscaled in the browser before upload.
Documentation
Project Structure
src/ React application code
src/components/ UI components
src/hooks/ React hooks
src/services/ Cloud, payment, and sync services
src/utils/ Storage, currency, notification, and validation utilities
content/blog/ Public SEO guides (static HTML at `/blog` and `/zh/blog`)
scripts/blog/ Build-time blog HTML, sitemap, and robots generator
netlify/functions/ Serverless functions
supabase/ SQL setup and migrations
tests/ Node test runner utility tests
docs/ Public documentation, split by language
docs-site/ Mintlify documentation site, split by language
dev-docs/ Development notes and archived implementation drafts
Landing page
The main domain serves the product landing page; the application lives at /app on the same origin (https://steadyrenew.com/app in production). The page supports English, Simplified Chinese, light/dark themes and mobile layouts. Set VITE_SITE_URL for canonical metadata and VITE_APP_URL for the application entry. See the domain configuration guide and migration status.
Search engines
Bing Webmaster Tools is verified with public/BingSiteAuth.xml, served at /BingSiteAuth.xml, and a msvalidate.01 meta tag in index.html. Prerendered marketing pages reuse that shell. The blog HTML shell includes the same tag. Documentation pages are proxied from Mintlify and do not have a local HTML shell.
IndexNow uses the key file public/16274743d7549a346d2cf33abbd2d73d.txt. npm run indexnow reads dist/sitemap.xml and dist/docs/sitemap.xml when those files exist, otherwise fetches https://steadyrenew.com/sitemap.xml and https://steadyrenew.com/docs/sitemap.xml, then POSTs the URLs to IndexNow. A production Netlify deploy runs the same script from onSuccess. That step is skipped outside production, and a submission failure does not fail the deploy. The SPA fallback is not forced, so both verification files stay static responses.
Public guides
/blog is a static content hub on the main website (https://steadyrenew.com/blog). Chinese guides use /zh/blog. Add a Markdown file to content/blog/ — see Public guides.
License
This project is licensed under the MIT License. See LICENSE for details.
