Architecture Overview

The Reformer Platform is a modular automation stack that connects a Node.js/Express API, a React dashboard, and several third-party services (Stripe, ClickUp, Dropbox, Close CRM, Resend, Slack, Cal.com, Intercom, Vimeo, Spotify, Hunter, Pirsch, PageSpeed, Webflow AI). 15 custom MCP servers provide AI assistants with direct access to all services. This page shows how those pieces fit together and where to start when troubleshooting or extending the system.

Core Components

Component	Location	Purpose
Backend API	reformer-platform/src/server.js	Express server exposing onboarding, billing, integrations, and health endpoints.
Automation Orchestrator	reformer-platform/services/automation-orchestrator.js	Central coordinator invoked by onboarding flows; dispatches downstream integrations.
Frontend Dashboard	/dashboard	React/Vite app surfaced to internal team and clients (Cloudflare Pages).
Database	Supabase PostgreSQL (DATABASE_URL)	Stores members, integrations, automation state.
Integrations	reformer-platform/services/*.js	Service-specific SDK wrappers (ClickUp, Slack, Dropbox, Resend, Close, etc.).
MCP Servers	reformer-platform/mcp-servers/*/	15 custom MCP servers providing AI assistants with direct access to all services.

Request Flow (Onboarding v2)

1. Trigger: Dashboard or external system sends POST /api/onboarding-v2 with member details.
2. Validation: Express route validates payload, logs request, and normalizes data.
3. Orchestration: automation-orchestrator.js kicks off tasks:
   • Create ClickUp project structure (clickup-service.js).
   • Generate Dropbox folders (dropbox-service.js).
   • Send Resend onboarding emails (resend-service.js).
   • MCP servers enable AI assistants to manage all services directly from Cursor.
   • Notify Slack (slack-service.js).
   • Update Close CRM lead (close-service.js).
4. Result: Response returns success/failure per integration; errors routed to alerting channel.

Hosting & Environments

Environment	Base URL	Notes
Development	http://localhost:10000	Run via npm run dev. Uses local env file with test credentials.
Staging	https://staging.reformer-platform.pages.dev	Optional; inherits staging API base.
Production	https://reformer-platform.onrender.com	Render.com service; all env vars configured per reformer-platform/ENV-TEMPLATE.md.

Frontend dashboard is deployed separately on Cloudflare Pages (Webflow build) and communicates with the backend via the environment-specific API base URL.

Key Files

• reformer-platform/src/api/onboarding-v2.js – Primary onboarding endpoint.
• reformer-platform/src/api/checkout.js – Stripe billing flow.
• reformer-platform/services/* – Integration wrappers (ClickUp, Slack, Dropbox, etc.).
• reformer-platform/scripts/* – Automation helpers (ClickUp setup, bug updates).

Next Steps

• Review Integrations Index to see service-specific configuration.
• Use the API Overview for endpoint documentation.
• Follow the Daily Runbook to operate the platform safely.***