subscription-management

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Uyari
  • process.env — Environment variable access in mcp/src/server.mjs
  • network request — Outbound network request in mcp/src/server.mjs
  • network request — Outbound network request in netlify/edge-functions/docs-proxy.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Local-first subscription and free-trial tracker without bank login — multi-currency totals, Bark reminders, AI capture, PDF reports, REST API & MCP.

README.md

SteadyRenew

English | 简体中文

Use online: steadyrenew.com · App: steadyrenew.com/app · Docs: steadyrenew.com/docs

SteadyRenew is a local-first web app for tracking recurring subscriptions and free trials without linking your bank. It supports multi-currency totals, Bark push reminders, AI-assisted capture, print-ready A4 PDF reports, optional cloud sync, and Developer API & MCP integrations.

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, Passkey sign-in, Lifetime Premium checkout, server-side reminders, or API/MCP automation.

https://github.com/user-attachments/assets/a7bb1549-0076-4aa8-a8d8-4a6d5ba0e17c

Add a subscription with AI Assist — type a sentence, review the draft, apply.

https://github.com/user-attachments/assets/08f934dc-0460-4085-a0ba-f2d5193de3d1

Add a subscription manually — fill in the form, save, and see it appear.

Exported snapshot PDF report with totals, category bars, and a subscription table Exported annual PDF report with a monthly spend trend chart and category totals

Print-ready A4 PDF reports: current snapshot and annual spend (sample data).

Features

  • Track recurring subscriptions and one-shot free trials 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, status, 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 client-side print-ready A4 PDF reports (current snapshot and annual spend)
  • Use optional Supabase authentication (email/password, OAuth, and Passkeys) and multi-device sync
  • Send optional Bark push reminders for upcoming renewals and free-trial endings
  • Connect AI assistants via hosted Streamable HTTP MCP (/api/mcp), single-file local stdio MCP (/downloads/steadyrenew-mcp.mjs), or the /api/v1/* REST API
  • Use light or dark mode on desktop and mobile

Tech Stack

  • React 18 & TypeScript
  • Vite & Tailwind CSS
  • i18next & Recharts
  • Supabase (Auth, Postgres + RLS, WebAuthn Passkeys)
  • Netlify Edge Functions & Serverless/Scheduled Functions
  • Model Context Protocol (@modelcontextprotocol/sdk)
  • Stripe Checkout & Webhooks

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 (/app opens the tracker).

To test Netlify Functions locally (/api/v1/*, /api/mcp, AI capture, Stripe, or scheduled notifications), 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 (frontend + Functions)
npm run build               # Build frontend, agent/MCP assets, and prerendered pages
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, Functions, and Node script TypeScript checks
npm run test                # Run utility and SEO/blog tests
npm run test:functions      # Run Netlify Functions and Edge Function tests
npm run db:verify           # Reset, lint, and test local Supabase migrations
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 (see .env.example for full details):

Service Variables Purpose
Site & origins VITE_SITE_URL, VITE_APP_URL, VITE_DOCS_URL, SITE_URL Canonical public origin, /app entry, /docs URL, and server return URLs
Supabase VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY, SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY, SUPABASE_SECRET_KEY (or SUPABASE_SERVICE_ROLE_KEY) Authentication, Passkeys, cloud sync, notifications, API keys, and AI quotas
Stripe VITE_STRIPE_PUBLISHABLE_KEY, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_ID, STRIPE_MODE, PRODUCTION_SUPABASE_URL $9 one-time Lifetime Premium checkout, environment safety guards, and webhook reconciliation
Public API & MCP API_RATE_LIMIT_PER_MINUTE, API_MAX_ACTIVE_KEYS, API_FAILED_AUTH_RATE_LIMIT_PER_HOUR, API_RATE_LIMIT_RETENTION_HOURS Optional overrides for API/MCP limits (defaults: 60/min, 5 active keys)
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 per user in Settings → Notifications Push reminders for upcoming renewals and free trials
Netlify URL (provided by Netlify), MINTLIFY_UPSTREAM_ORIGIN Deployment callback fallback and optional /docs proxy upstream override

AI capture & privacy

AI capture can start from a sentence, a pasted bank/credit-card statement excerpt, 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 (google/gemini-2.5-flash-lite with google/gemini-2.5-flash as fallback). Anthropic remains available via AI_PROVIDER=anthropic + ANTHROPIC_API_KEY; leaving provider keys unset falls back to the manual form.
  • Volume & cost control. Signed-in users receive a monthly parse quota (10/month on Free, 300/month on Lifetime Premium, charged on successful parses only), every request caps input size, and a workspace-wide monthly budget breaker pauses the feature once the configured spend ceiling is reached. Provider keys stay 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 monthly counter, never the content. Screenshots are downscaled in the browser before upload.

Documentation

Canonical bilingual documentation lives in docs-site/ (steadyrenew.com/docs):

Project Structure

src/                      React application code (/app, landing, pricing, legal)
content/blog/             Public SEO guides (static HTML at /blog and /zh/blog)
scripts/                  Build-time prerender, blog, agent/MCP asset, and verification scripts
mcp/                      Standalone local stdio MCP server source & package tests
netlify/edge-functions/   Edge routing (smart-entry.ts) and /docs Mintlify proxy (docs-proxy.ts)
netlify/functions/        Serverless & scheduled functions (/api/v1/*, /api/mcp, AI, Stripe, Bark)
supabase/                 Timestamped SQL migrations, pgTAP tests, and local config
tests/                    Node test runner suites (utils, functions, browser sync, Playwright payments)
docs-site/                Canonical Mintlify documentation site (en/ & zh-CN/) and OpenAPI/AI schemas
docs/                     Navigation indexes, /agent/setup.md source, and operations runbooks
dev-docs/                 Internal maintainer guides and archived implementation notes

Landing page

The main domain serves the prerendered product landing page; the application lives at /app on the same origin (https://steadyrenew.com/app in production). Set VITE_SITE_URL for canonical metadata and VITE_APP_URL for the application entry. See the landing page & domain notes and domain migration runbook.

Search engines

Bing Webmaster Tools is verified with public/BingSiteAuth.xml (/BingSiteAuth.xml) and a msvalidate.01 meta tag in index.html. IndexNow uses public/16274743d7549a346d2cf33abbd2d73d.txt, and npm run indexnow submits URLs from sitemap.xml and /docs/sitemap.xml after production deploys without failing the deploy if submission errors occur.

Public guides

/blog is a static content hub on the main website (https://steadyrenew.com/blog); Chinese guides live at /zh/blog. Add a Markdown file to content/blog/ — see Public guides authoring.

License

This project is licensed under the MIT License. See LICENSE for details.

Yorumlar (0)

Sonuc bulunamadi