previews · Changelog

Changelog

Platform and tooling changes to the html-previews app itself — hosting and auth, the comment / reaction / approval system, search, the design system, and the cross-preview conventions.

This is not a log of content — the artifacts the platform hosts, *including generated ones*. Publishing a preview (an RCA, an architecture doc, a sprint report, the service catalog, a code-analysis dashboard) does not get an entry here. The test: would every preview benefit (platform), or is it one more thing published on the site (content)? See AGENTS.md for when to add an entry.

3 Jul 2026

  • Fixed duplicate comments from the inline editor — with an edit open, the popover composer was wired to the edit textarea (the popover's first <textarea>), so Cmd/Ctrl+Enter or the send button posted the draft as a brand-new comment instead of (or as well as) saving the edit. Also guarded the panel reply and video composer against double-submit (assets/comments.js).

29 Jun 2026

  • Slack link previews — pasting any preview link in Slack now unfurls a branded card — title, summary, and a per-doc image on the warm gradient — instead of a blank Vercel placeholder. A Slack app calls a webhook (api/slack-events) that reads the SSO-gated page server-side and renders the card with @vercel/og; card images are served from a separate public Blob store, so the documents themselves stay private.

23 Jun 2026

  • Discussions panel — a top-right button opens a Notion-style index of every thread on the page; click a current thread to jump to it and open its popover.
  • Comments survive edits — a comment whose text has been edited away no longer disappears. It moves to the panel under "On a previous version", showing the paragraph it was left on and a link to the commit it was made against. New comments snapshot their containing paragraph and are stamped with the deployed commit (assets/comments.js, api/comments.js).
  • Comment on code, tables and more — the commentable surface now covers code blocks (<pre>), table cells, all heading levels and captions, not just paragraphs and h2/h3. Selecting text inside a code block also makes line- and token-precise comments work there. Mermaid diagrams are deliberately left out, pending a pin-based model.

18 Jun 2026

  • Comments widget: no more horizontal scroll on mobile — gutter comment markers (and the floating chrome) could be placed past a phone's right edge; they're now clamped to the viewport.
  • Changelog page — CHANGELOG.md now renders as a styled page at /changelog/, linked from the site footer. Generated by scripts/build-changelog.mjs.
  • Architecture page: full-text search + grouped grid. The category page is now data-driven — instant client-side search over each doc's title, summary and body, with results ranked and matched terms highlighted, plus a card grid grouped by week (toggle to month). Generated by scripts/build-index.mjs → architecture/index.json; counts no longer drift from a hand-maintained list.

12 Jun 2026

  • "Copy for Claude Code" button on plan pages — one click to copy a page reference (with its pulled discussion) back into a Claude Code session.
  • Research category added for competitive landscapes and external grounding.

11 Jun 2026

  • Discussion presence and editing — viewer facepile with idle dimming, per-comment emoji reactions, who-reacted-on-hover, edit-your-own-comment, text-selection highlight comments, and Cmd/Ctrl+Enter to send.
  • scripts/pull-comments.mjs — pull a preview's discussion (comments, reactions, approvals, viewers) straight from the Blob store, bypassing the Vercel auth gate, for agents and scripts.
  • House style and enforced design system codified in AGENTS.md — the blog-post standard, design tokens, fonts, gradient, and motion.

10 Jun 2026

  • Persistent discussions — Notion-style margin comments anchored to blocks, per-block emoji reactions, and DocuSign-style signature approvals, stored one-blob-per-item in Vercel Blob behind the auth gate (api/comments.js, assets/comments.js).

27 May 2026

  • Multi-layer navigation rule documented, with a fix for stale category counts across nav levels.

12 May 2026

  • Typed categories — previews reorganised into rcas/, architecture/, sprint-reports/, etc.; folder path becomes the URL.
  • AGENTS.md authoring guide — use cases, FAQ, and the contract for generating previews that match the house style.

11 May 2026

  • Initial platform — self-contained HTML previews, one folder per preview, path = URL, with the "why HTML over markdown" framing.
  • Hosting on Vercel (migrated from GitHub Pages), gated by Lawhive team authentication.