Skip to main content
Docs

5. Architecture at a glance

mdcms is a pnpm monorepo with three layers:

Cloudflare PagesOpenRouterPostgreSQLConverter(FastAPI · Python)API Server(Express + tsx)Preview Iframe(React)Web SPA(React + Vite)BrowserCloudflare PagesOpenRouterPostgreSQLConverter(FastAPI · Python)API Server(Express + tsx)Preview Iframe(React)Web SPA(React + Vite)Browsereditor.tldpostMessage(RENDER_DOCS)GET /api/.../generateSELECT pagechatComplete (mapper)ComponentMapping[]prerender mermaid via JSDOM{ html, sections }PREVIEW_READYClick DeployPOST /api/.../deploygenerateStaticSite()Upload .html filesdeployment.url{ deploymentId, url }
Cloudflare PagesOpenRouterPostgreSQLConverter(FastAPI · Python)API Server(Express + tsx)Preview Iframe(React)Web SPA(React + Vite)BrowserCloudflare PagesOpenRouterPostgreSQLConverter(FastAPI · Python)API Server(Express + tsx)Preview Iframe(React)Web SPA(React + Vite)Browsereditor.tldpostMessage(RENDER_DOCS)GET /api/.../generateSELECT pagechatComplete (mapper)ComponentMapping[]prerender mermaid via JSDOM{ html, sections }PREVIEW_READYClick DeployPOST /api/.../deploygenerateStaticSite()Upload .html filesdeployment.url{ deploymentId, url }

A total of 5 apps and 6 packages, all in one repo.#