Deployment
SteadyRenew is configured out of the box for Netlify, combining a static + prerendered Vite frontend with Netlify Edge Functions and serverless/scheduled Functions. The frontend alone can also be hosted on any static host in local-first mode.Build output
npm run build runs vite build && tsx scripts/prerender.ts and writes to dist/:
/appSPA shell (dist/app/index.htmlvia/* -> /app/index.htmlfallback).- Prerendered static marketing, pricing, legal, and blog pages (
/,/zh,/about,/pricing,/zh/pricing,/privacy,/terms,/blog/*,/zh/blog/*,/sitemap.xml,/robots.txt). - Agent & MCP artifacts (
/agent/setup.md,/agent/ai-tools.json,/agent/openapi.yaml,/downloads/steadyrenew-mcp.mjs,/downloads/subscription-manager-mcp.tgz).
Netlify routing (netlify.toml)
netlify.toml configures:
- Build command:
npm run build, publish directorydist, Node22. - Edge Functions (
netlify/edge-functions/):smart-entry.tson/— routes returning app users or localized visitors cleanly while keeping crawlers on the static landing page.docs-proxy.tson/docs,/docs/*, and/.well-known/vercel/*— reverse-proxies the Mintlify documentation site under/docswith immutable caching for/docs/_next/static/*assets andno-storefor HTML pages.
- Public API & MCP redirects:
/api/mcp→/.netlify/functions/api-mcp/api/v1/subscriptions&/api/v1/subscriptions/*→/.netlify/functions/api-v1-subscriptions/api/v1/notification-settings→/.netlify/functions/api-v1-notification-settings/api/v1/analytics/*→/.netlify/functions/api-v1-analytics/api/v1/audit→/.netlify/functions/api-v1-audit
- SPA fallback:
/*→/app/index.html(200), served after static files indist/. - Security & CORS headers: CSP,
X-Frame-Options: DENY,X-Content-Type-Options: nosniff, and permissive CORS + explicit MIME types on/llms.txt,/agent/*, and/downloads/*.
/BingSiteAuth.xml plus a msvalidate.01 meta tag. IndexNow serves /16274743d7549a346d2cf33abbd2d73d.txt and submits sitemap URLs via npm run indexnow after production deploys without failing the deploy on network errors.
Serverless & scheduled Functions
netlify/functions/ includes:
Use Netlify Dev for local end-to-end function testing:
Pre-deploy checklist
- Run
npm run check(typecheck,lint,test,test:functions, andbuild). - Apply all Supabase SQL migrations in
supabase/migrations/before enabling cloud sync, Passkeys, API keys, AI capture, payments, or scheduled notifications. - Configure only the environment variables needed for your enabled services (including
STRIPE_MODE=liveon production andPRODUCTION_SUPABASE_URLon staging). - Point your Stripe webhook endpoint at
https://your-domain.example/.netlify/functions/stripe-webhookwith the events listed in Payments with Stripe. - If you changed documentation under
docs-site/, runcd docs-site && mint broken-links(andmint validatebefore major structure changes).