Skip to content

Releases: livetemplate/docs

v0.0.1 — initial public alpha

03 May 17:51

Choose a tag to compare

First public alpha of the LiveTemplate documentation site.

Live at https://livetemplate.fly.dev.

What's in v0.0.1

Information architecture (Phase 2): 40 pages mirrored from the four source repos (`livetemplate`, `client`, `lvt`, `examples`) with the source-of-truth contract at `content/_meta/source-of-truth.{md,yaml}`. Edit-on-GitHub links point at the source repo, not this docs site.

Sync automation (Phase 3): GitHub Action opens a PR in this repo on every source repo release, refreshing the mirrored markdown.

Live patterns catalog (Phase 4): `/patterns/` reverse-proxies to the deployed `lt-patterns.fly.dev` showcase. The catalog landing is itself driven by an `lvt-source` REST binding to the same upstream — the page count auto-syncs on each fly-deploy of the patterns app.

Interactive recipes (Phase 5): seven recipes under `/recipes/` — the framework explained via mermaid sequence diagrams + decision-tree flowcharts + live data bindings to GitHub releases and the patterns API. Includes the meta-recipe at `/recipes/how-this-site-works` explaining the dogfood loop.

Production launch (Phase 6a):

  • Auto-deploy on push to main via `.github/workflows/deploy.yml`
  • SEO infra in tinkerdown v0.1.2: `/sitemap.xml`, `/robots.txt`, OpenGraph + Twitter card meta in every page ``
  • G4 perf fix in tinkerdown v0.1.2: render-blocking script loads removed; Mermaid runtime conditionally loaded only on pages that contain ```mermaid blocks. Lighthouse perf: 97-98 on non-diagram pages.

Known issues

  • G16 — diagram pages are slow. Pages containing inline mermaid diagrams (`/recipes/architecture-flow`, `/recipes/sync-and-broadcast`, etc.) score Lighthouse perf 55 because the 3.3MB Mermaid runtime is the dominant cost even after the v0.1.2 conditional-load fix. Tracked for the next tinkerdown release; will likely land as IntersectionObserver-based lazy-load + an eventual server-side pre-render to inline SVG.

Provenance

This is alpha software (`v0.0.x`). The numbering signals "this exists" not "this is stable." API surface, content layout, and tinkerdown features may change without warning until `v0.1.x`.

🤖 Generated with Claude Code