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

• Mintlify documentation site source
• Documentation index
• Getting started
• Configuration
• Deployment
• Public guides (/blog)
• Cloud sync with Supabase
• Renewal reminders with Bark
• Payments with Stripe
• AI capture
• Public API
• Connect your agent (Copy to Agent)
• Changelog

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.