Open source · Web & UX

Client-Only Rendering Detector

Detect routes that depend on client-only rendering for essential content.

v1.0.0 · Node.js 22+ · MIT

Browse the public repository · View releases

An offline, read-only comparison of exported server HTML and a separately captured local render snapshot for configured essential headings, text and links. The tool never opens a browser, fetches a page, runs scripts, or changes a site. Its result is limited by the completeness and trustworthiness of the supplied capture.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/client-only-rendering-detector.mjs --root examples/passing --server server.html --render render.json --config config.json
node bin/client-only-rendering-detector.mjs --root examples/failing --server server.html --render render.json --config config.json
npm run check

Read the result

The passing command exits 0; the failing command exits 1 with client-only-essential for the first configured item. Use --out report.json to save the same JSON report in the evidence root, or --human for a short stderr summary. The JSON report is always sent to stdout unless output destination validation fails. Bad CLI configuration and refused output destinations exit 2 with empty stdout.