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.

Zur Installation springen

Repository: digirati-co-uk/madoc-platform
Letzte Quellaktivität: 5. Februar 2026 um 21:05
Erkannte Sprache von SKILL.md: Englisch
Sterne: 57
Forks: 15

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

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

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

2 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

crowdsourcing-task-review-workflow

Understand and modify the full Madoc TS crowdsourcing contribution and review pipeline. Use when changing claim creation rules, crowdsourcing-task and crowdsourcing-review lifecycle behavior, reviewer assignment policy, or project settings that control submission/review flow in services/madoc-ts.

2026-05-07

frontend-site

Work on Madoc TS site UI structure, React routes, and site-specific SSR behaviors. Use when adding or updating site pages, loaders, or site theme usage in services/madoc-ts.

2026-04-14

madoc-docker-ops

Build, run, and debug the Madoc Docker/compose stack with the Docker daemon already running, including rebuilding images, starting/stopping services, inspecting containers/images, and using pm2 inside the madoc-ts container (server/queue/scheduler/auth) plus frontend rebuilds for volume-mounted assets.

2026-04-08

Alle aus diesem Repository ansehen

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

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

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

Mehr aus diesem Repository

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