~/field-notes — leeguoo@misonote — zsh ● EN 中文 日本語
❯ field-notes v3.4.1

← 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.

⎇ main ● 0 errors · 0 warnings UTF-8 Markdown page.md © 2026 leeguoo