leeguoo

← Docs

HTML-first doc platform sample

Phase 1 end-to-end sample: themed scoped rendering, design token cascade, doc: protocol links, relative asset paths.

2026-05-12#demo#html-first

What this is

This is the Phase 1 end-to-end sample for the HTML-first doc platform. It proves four things:

  • An HTML package can be validated, transformed, and built into the registry by doc-cli.
  • Themed scoped rendering keeps inline <style> from polluting the host site.
  • Design tokens cascade through --platform-* automatically.
  • doc: protocol links are rewritten to in-site URLs.

Token cascade demo

Token cascade diagram

Internal references use the doc: protocol, rewritten by Transform: this is an intentional broken link; Phase 1 marks it as a doc-link-broken warning but does not block publish.