What problem does it solve?
It solves the problem of turning scattered, multi-agent HTML outputs into a single coherent mini-site that reliably works offline and via file:// while keeping navigation, assets, and link integrity consistent.
Core Features & Use Cases
- Offline-first publishing: bundles required third-party vendor libraries into local
assets/vendor/ and rewrites external and stray local asset references so pages load without network access.
- Deterministic visual identity: generates a large hero seal and a matching mini seal, then injects the mini seal across all generated pages.
- Single source of truth for data: compiles all intermediary JSON artifacts into one
assets/js/data.js consumed by pages through window.RV_DATA, avoiding fetch() under file://.
- Index and discovery integration: produces
index.html and performs HTML auxiliary auto-discovery based on reversa-category metadata, then links auxiliary sections into the final index.
- Validation and resilience: validates relative links, applies placeholders for omitted pages when needed, runs a smoke test, and records final telemetry in
.state.json including CDN fallback and failure details.
Quick Start
Run /reversa-docs-publisher to generate .reversa/documentation/index.html, embed the mini-selo and navigation into the existing HTML pages, and update .reversa/documentation/assets/js/data.js and .reversa/documentation/.state.json.