Changelog
What's new in superlore — every release as a complete record an agent can query, with a hero, highlights, grouped changes, and what's coming next.
Every superlore release is a complete record — a hero, the marquee highlights, and changes grouped into sections — and every block is typed, so an agent over MCP reads the same release you do.
The MCP serves the whole corpus — body, grep, and glob
Highlights
The readable body (raw MDX) + headings + typed nodes, so an agent can actually read a page — prose pages are no longer empty.
Regex over every page body, line by line — ripgrep-style { path, line, text } hits, scoped by a path glob.
List page paths by shell-style pattern — the corpus's file finder.
- MCP tool grep(pattern, flags?, path?, limit?) — regex search across page bodies, returning { path, line, text }.MCP tools
- MCP tool glob(pattern) — list page paths matching a shell-style glob.
- buildIndexFromSource(source, { readContent }) — wire a reader to serve the raw authored MDX body; without it, bodies fall back to extracted prose.
- get_page now returns the page body + headings, not just frontmatter — the index reads the real content, so search ranks over it too.
- The scaffolded MCP route ships grep + glob and serves raw MDX out of the box.
Releases, round two — multi-select filter, timeline options, hideToc
Highlights
Filter the changelog by any number of features at once (OR). Renamed Filter features, with a count badge and one-click clear.
Dots clear the month labels, crowded versions never overlap, the latest wears the accent — plus a new strip variant beside the date axis.
Self-navigating pages (a Releases changelog) can drop the flat "On this page" list; the timeline and rail already navigate.
- Releases gains a timeline prop — axis (default, the date rail), strip (evenly-spaced stops), or off.
- hideToc frontmatter flag hides the table of contents while keeping the centred layout — set it on a changelog.
- The feature filter is multi-select and renamed Filter features; each release's rail tags double as filter toggles.
- Timeline layout: dots no longer collide with the month labels, stacked release cards never overlap, and the latest release is accented.
superlore 0.12 — themes, reimagined releases, runtime safety
Highlights
default · mint · geist · ledger · obsidian · prism · paste — pick a skin with one flag in superlore.json, zero .mdx edits.
Media-first entries, a Highlights grid, grouped sections, and a collision-free timeline.
A bad token in prose degrades to a fallback instead of blanking the host page.
llms.txt + llms-full.txt, JSON-LD, and per-page canonical/OG — built in.
- Theme system — seven production themes scoped to data-sl-theme; accent + font stay orthogonal brand overrides.Themes
- Release component reimagined — media-first entries (image lightbox + video facade), a Highlights grid, grouped sections, and an area jump-rail.
- superlore.json gains logo { light, dark, href } + favicon; accent now drives the whole palette.
- Discoverability: /llms.txt + /llms-full.txt, JSON-LD, and per-page canonical + Open Graph.
- A Why superlore page, plus a release-notes skill + Remotion reel pipeline.Why superlore
- The release timeline never overlaps — a lane layout stacks crowded versions at different heights.
- Sidebar hierarchy — section headers read distinct from page items; collapse persists (⌘\).
- A bad {token} in prose now degrades gracefully instead of blanking the page (a render-time error boundary).
Embeddable runtime + Powered-by badge
Highlights
Every rule is scoped to the doc container — import it app-wide and the host's own pages don't move a pixel.
A small floating badge on every embedded doc — branding by default, one prop to remove.
- superlore/runtime.css is fully scoped to a .superlore-doc container — import it app-wide with a 0-pixel host diff.
- SuperloreDoc stamps a floating 'Powered by superlore' badge (opt out with badge=false).
- Dark mode is container-local via data-theme on the doc — two docs can render different themes on one page.
- Code blocks keep their tokyo-night surface even when a host webview drops Shiki's CSS variables.
Host-native rendering
Highlights
SuperloreDoc, useSuperloreMdx and compileMdxSource render an MDX string live in any React app.
SuperloreTheme renders superlore in the host's brand via a CSS-variable contract.
- superlore/runtime — render an MDX string live in any React app (SuperloreDoc, useSuperloreMdx, compileMdxSource).
- SuperloreTheme — render superlore in the host's palette via a CSS-variable contract.
- The extension now installs from the Open VSX registry, so it auto-updates.Connect
Markdown-first authoring
- Task lists render as a Checklist; NOTE/TIP alerts render as Callouts — natural markdown, dual-rep components.
- Canvas edge labels reserve a lane in layout, so fan-in connectors never overlap.
- Code blocks are always dark, in any page theme, on a tokyo-night surface.