ssr-pipeline

Trace or modify Madoc TS server-side rendering for site and admin. Use when changing SSR output, template injection, dev HMR SSR wiring, or debugging SSR redirects and template tokens in services/madoc-ts.

Ir a la instalación

Repositorio: digirati-co-uk/madoc-platform
Última actividad en el origen: 5 de febrero de 2026 a las 21:05
Idioma detectado de SKILL.md: inglés
Estrellas: 57
Forks: 15

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/digirati-co-uk/madoc-platform --skill ssr-pipeline

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

2 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

name	ssr-pipeline
description	Trace or modify Madoc TS server-side rendering for site and admin. Use when changing SSR output, template injection, dev HMR SSR wiring, or debugging SSR redirects and template tokens in services/madoc-ts.

SSR Pipeline (Madoc TS)

Overview

Explain how server-side rendering is performed for site and admin, how SSR output is injected into HTML templates, and how dev-mode HMR SSR output is constructed.

Key Entry Points

Site SSR handler: services/madoc-ts/src/routes/frontend/site-frontend.ts
Admin SSR handler: services/madoc-ts/src/routes/frontend/admin-frontend.ts
Site template: services/madoc-ts/src/site.html
Admin template: services/madoc-ts/src/admin.html
Client entrypoints referenced in templates:
- services/madoc-ts/src/frontend/site/client.ts
- services/madoc-ts/src/frontend/admin/client.tsx

SSR Flow Summary (Based on Source)

Both site and admin handlers set context.staticPage to an async renderer.
Each renderer calls a corresponding render* function:
- Site: renderSite from src/frontend/site/server
- Admin: renderAdmin from src/frontend/admin/server
The render result includes body, head, htmlAttributes, and bodyAttributes.
If result.type === 'redirect', the handler returns a redirect (status result.status || 307) or a 404 if no to is provided.
In NODE_ENV === 'development', HTML is built inline with Vite HMR scripts and a dynamic host-based dev URL (port 3088).
In non-dev, context.siteTemplate or context.adminTemplate is used, with token replacement:
-  replaced by result.body
-  replaced by result.head
- <html> and <body> tags are replaced to include attributes from SSR output.

Quick Start Workflow

Inspect site-frontend.ts and admin-frontend.ts to see how context.staticPage is set and how SSR results are injected.
Confirm template token usage in site.html and admin.html.
For dev SSR, verify HMR and client script injection for the correct entrypoints:
- Site: /src/frontend/site/client.ts
- Admin: /src/frontend/admin/client.tsx
If changing SSR output shape, ensure callers handle result.type === 'redirect' and result.body/head expectations.

Development Mode Details

Dev HTML includes @react-refresh and a viteProtocol derived from TLS certs at /home/node/app/openssl-certs.
Hostname is taken from context.request.hostname.
Site adds a stylesheet link to src/frontend/site/index.css in dev mode.

Common Tasks

Update SSR head/body injection
Debug SSR redirect behavior
Add SSR-injected assets (ensure matching template tokens)
Troubleshoot dev HMR SSR boot failures

Pitfalls

Missing or renamed template tokens (, )
Mismatch between SSR output and template replacement
HMR dev URLs breaking on custom hostnames or protocol mismatch

Suggested Checks

One request to a site page (SSR HTML contains result.head and result.body)
One request to an admin page (SSR HTML contains result.head and result.body)
In dev, confirm the HMR preamble loads and the client entrypoints are correct

ssr-pipeline

Datos de origen

Opciones de instalación

Revisa los archivos de origen

Más de este repositorio

Más de este repositorio

SSR Pipeline (Madoc TS)

Overview

Key Entry Points

SSR Flow Summary (Based on Source)

Quick Start Workflow

Development Mode Details

Common Tasks

Pitfalls

Suggested Checks

SSR Pipeline (Madoc TS)

Overview

Key Entry Points

SSR Flow Summary (Based on Source)

Quick Start Workflow

Development Mode Details

Common Tasks

Pitfalls

Suggested Checks