What problem does it solve?
Reversa-docs-publisher turns multiple independently generated HTML outputs into a single coherent mini-site with consistent navigation, branding, offline-ready assets, and final validation.
Core Features & Use Cases
- Generates a branded, deterministic seal: creates both hero seal and mini seal SVGs from the project seed, ensuring unique identity across regenerations.
- Builds a single data source for all pages: embeds intermediate JSON data into
.reversa/documentation/assets/js/data.js as window.RV_DATA, preventing local-file fetch/CORS issues.
- Finalizes the mini-site pipeline: injects the mini seal and navigation into every generated page, auto-discovers auxiliary HTML pages by metadata, validates relative links, downloads required vendor libraries locally for offline use, and updates final telemetry.
- Ensures operational safety: enforces offline-first invariants, performs a smoke test checklist, and records failures like missing vendor libraries or broken links into
.reversa/documentation/.state.json.
Quick Start
Ask the agent to run reversa-docs-publisher for the current documentation build, then open .reversa/documentation/index.html to verify navigation, offline rendering, and the generated seal branding.