Changelog

All notable changes to Sourcey. Format based on Keep a Changelog.

Unreleased

Next release

Fixed

OpenAPI sidebar tag headings now link to the tag introduction section, so long tags[].description guidance is directly reachable from navigation.

3.6.2

June 5, 2026

Fixed

Rust re-exports (use items) now render with their real name and a pub use signature instead of an empty reexport. placeholder, and appear correctly in the sidebar, page outline, and search.

3.6.1

May 31, 2026

Added

rustdoc() source adapter for native Rust API documentation. Consumes nightly rustdoc JSON via a bundled Rust helper crate, emits a stable v1 RustdocSpec snapshot, and renders sourcey-native pages consistent with the openapi, mcp, godoc, and doxygen adapters; inbound docs.rs-style deep-link anchors still resolve. Supports auto, live, and snapshot modes; snapshot mode requires no Rust toolchain so CI can build docs on stable.
Sourcey-native rustdoc rendering: workspace and crate indexes use the shared card grid, items render inline as sections, signatures keep clickable cross-references, doctests flow through the shared syntax-highlighting pipeline, and trait implementations collapse behind a single styled disclosure while auto/marker traits stay a quiet list.
First-class rustdoc doctest extraction with hidden-line stripping, fence-attribute badges (ignore, no_run, should_panic, compile_fail, editionYYYY), Rust Playground deep-links, and a workspace-wide doctests index page that aggregates every runnable example.

3.6.0

May 15, 2026

Added

Source adapters as the primary tab configuration shape: source: markdown(...), mkdocs(...), openapi(...), mcp(...), doxygen(...), and godoc(...).
mkdocs() source adapter for importing existing mkdocs.yml / mkdocs.yaml sites. Sourcey reads docs_dir, nav, and legacy pages, preserves explicit page labels, flattens nested MkDocs sections into Sourcey sidebar groups, expands snippets, normalizes admonitions/tabs, and carries static assets into the build.

Changed

sourcey init, first-party docs, examples, and 0state docs configs now use the adapter form. Legacy direct tab fields remain supported for existing projects.

3.5.10

May 10, 2026

Fixed

Desktop sidebar scroll position now survives sidebar-initiated page navigation, so long generated docs sidebars no longer jump back to the top after selecting deep items in Doxygen/moxygen, OpenAPI, MCP, godoc, Markdown, or changelog tabs.
Direct, search-result, and external deep links now reveal the active sidebar item without reusing stale sidebar state.

3.5.9

May 6, 2026

Added

Native Go documentation as a fifth tab source (godoc). Sourcey extracts package docs directly from Go source via the toolchain (go list + go/parser + go/doc); no Doxygen pipeline. Supports live mode (runs Go at build time) and snapshot mode (reads a committed godoc.json); mode: "auto" (default) picks live when Go is available and snapshot otherwise. Renders consts, vars, functions, types (struct, interface, alias, defined), fields with tags, methods, and examples from *_test.go.
sourcey godoc --module . --packages './...' --out godoc.json CLI command to snapshot a Go module's documentation into a portable JSON artifact for JS-only docs hosts.
Standalone sourcey-godoc Go module and CLI at github.com/sourcey/sourcey/go/sourcey-godoc/cmd/sourcey-godoc, with generate for static Go docs sites, snapshot for portable JSON, and cross-platform GitHub release binaries on go/sourcey-godoc/v* tags.
goEnv option (GOOS/GOARCH/tags) for pinning the live-mode Go build environment so docs reproduce across hosts.
includeTests, includeUnexported, hideUndocumented, and exclude options on godoc tabs.
godoc package and symbol entries flow through the existing search index, llms.txt, llms-full.txt, and sitemap.xml pipelines.

Changed

Changelog page descriptions now render inline markdown so links and inline code resolve, with a constrained reading width and primary-tinted underlined links.
Unreleased version cards drop the dashed border for a primary-tinted left accent and soft tint, with a "Next release" pill in place of the empty meta row.

Fixed

Changelog parser no longer leaks bullet/paragraph tokens from non-SemVer headings into the page description, so trailing historical sections stop polluting the lead paragraph.

3.5.8

May 6, 2026

Added

sourcey dev --host <address> flag (and HOST env var fallback) to control the Vite dev-server bind address. Defaults to 127.0.0.1. Use --host 0.0.0.0 (or -e HOST=0.0.0.0 in Docker) to expose the dev server outside the host so the official sourcey/sourcey image's dev command works end-to-end.

3.5.6

May 5, 2026

Fixed

Output-relative .html links between generated pages now resolve through the active prettyUrls mode, cleaning Doxygen body links such as icy.html#anchor when prettyUrls: "strip" is enabled.

3.5.5

May 5, 2026

Fixed

Generated Doxygen page descriptions now render as plain text, preventing stale .html cross-reference links from appearing in page headers and metadata when prettyUrls: "strip" is enabled.

3.5.4

May 5, 2026

Fixed

Generated Godoc and Doxygen tab navigation now normalizes through the active prettyUrls mode, so prettyUrls: "strip" builds do not emit stale .html or index.html navigation links.

3.5.3

May 5, 2026

Fixed

prettyUrls: "strip" now emits foo.html files and public /foo links, without generated _redirects, so extensionless hosts do not loop between slashless and trailing-slash paths.
Internal markdown links that still point at .html pages are rewritten to the active pretty URL form when they resolve to a generated page.

3.5.1

May 4, 2026

Fixed

Sidebar nav and OpenAPI tab anchor base now honour prettyUrls ("slash" / "strip"). Previously hrefs were hard-coded to slug.html / tab/index.html, which 404 on hosts that don't auto-rewrite (e.g. GitHub Pages). Production sourcey.com masked the issue with its /foo.html → /foo/ 308 redirect.

3.5.0

April 24, 2026

Added

OpenAPI 3.2 parsing and rendering for QUERY operations, response summaries, deviceAuthorization OAuth flows, hierarchical tags, querystring parameters, and media-type encoding metadata
$self-aware reference resolution for canonical multi-document OpenAPI descriptions
prettyUrls config option for clean URLs ("slash" emits foo/index.html and links as /foo/; "strip" links as /foo and emits a _redirects file for static hosts that support redirect rules)

Changed

OG image template redesigned for legibility at Slack/Discord preview sizes: larger bold wordmark, vertical accent bar in theme primary, tighter type, single-grey description, no duplicate site-name footer

Fixed

Lint configuration for browser-side client scripts and generated MCP test artifacts

3.4.12

April 16, 2026

Added

Automatic per-page OG image generation at build time using Satori and resvg
ogImage config option for overriding with a static image URL
Heroicons in navigation and UI components

Changed

Inter loaded as the default sans-serif; layout rhythm refined for tighter vertical spacing

Fixed

Tab path deduplication when multiple tabs share a slug
Inline code styling inside TOC items
TOC nested-item border alignment

3.4.5

April 7, 2026

Added

Nested directives (e.g. tabs inside :::code-group)
Doxygen link rewriting for cross-referenced symbols in prose

Fixed

Inline code protection during markdown directive preprocessing

3.4.4

April 6, 2026

Fixed

OAuth security section rendering
Footer logo restored after layout refactor
Fenced markdown examples preserved through directive preprocessing

3.4.3

April 5, 2026

Added

::iframe directive for embedding arbitrary https URLs in markdown

Fixed

Doxygen page summaries now reuse resolved cross-links in page headers instead of exposing raw {#ref ... #} placeholders
Rich Doxygen index cards strip inline markdown link syntax from summaries
sourcey init now scaffolds projects against the latest published version again
Minimal-theme callout borders and responsive page description sizing
TOC sub-item margin alignment
Search featured pages, inline dialog, display font, and sidebar dot markers
Lighthouse baseline polish for generated docs

3.4.0

April 2, 2026

Added

MCP server documentation as a first-class input format alongside OpenAPI, Markdown, and Doxygen
mcp tab config option for rendering tools, resources, and prompts from an mcp.json snapshot
Auto-generated code samples in JSON-RPC, TypeScript SDK, and Python SDK for all MCP operations
Connection config card showing how to add the server to Claude, Cursor, or any MCP client
Annotation badges for tool hints (read-only, destructive, idempotent, open-world)
Colour-coded sidebar method pills (purple TOOL, green RES, blue PRMT)
Hot-reload for mcp.json files in the dev server
::video directive for embedding YouTube, Vimeo, or raw video files in markdown
Sitemap generation
OpenGraph and Twitter Card meta tags
Dockerfile for Docker Hub
Nix flake support

Changed

Sidebar active state uses pill-style background instead of left border
Table of contents uses a continuous grey track with primary colour active marker
Clicking the first sidebar item scrolls to the top of the page

Fixed

Dev server fs.allow now includes the sourcey root for npm link compatibility
Double-wrapped accordion groups from <AccordionGroup> component syntax

3.3.10

March 30, 2026

Changed

Package metadata moved to sourcey.com and sourcey/sourcey org

Fixed

Node 24 JSON import compatibility

3.3.9

March 28, 2026

Fixed

Page slugs preserve directory structure to avoid nav collisions

3.3.8

March 28, 2026

Fixed

slugFromPath preserves directory structure

3.3.7

March 27, 2026

Added

Relative source links in markdown rewrite to repo URLs at build time

3.3.6

March 27, 2026

Added

Doxygen index page generation

Fixed

Doxygen index content links

3.3.5

March 26, 2026

Fixed

CLI help output reports the actual package version
sourcey init scaffolds new projects with the latest published version

3.3.4

March 26, 2026

Changed

First page renders directly instead of meta-refresh redirect

3.3.2

March 25, 2026

Added

sourcey init auto-detects project type and offers directory selection
Init reads Doxygen XML_OUTPUT for proper path resolution

3.3.1

March 25, 2026

Fixed

Use jiti for TypeScript config loading
Resolve moxygen from npm registry

3.3.0

March 25, 2026

Added

sourcey init command for scaffolding new projects
Scroll tracker ?target query parameter for deep linking
Node 24 in CI test matrix

3.2.1

March 24, 2026

Fixed

Dev server asset path resolution for npm installs

3.2.0

March 23, 2026

Added

Internal link resolution between markdown pages
editBasePath config option for repos with docs in a subdirectory
Previous/next page navigation at the bottom of markdown pages
Brand icons (GitHub, npm, etc.) in navbar and footer

3.1.0

March 22, 2026

Added

Mobile navigation drawer with breadcrumbs
Configurable tab slugs
Collapsible schemas in API reference
"Edit this page" links on markdown pages
Auto Google Fonts loading from theme config

Changed

Stone-palette code surfaces
TOC nesting improvements

Fixed

Responsive layout at small breakpoints
Code indent rendering
Dev server error recovery
Sidebar active state on prose pages
Duplicate h1 headings
Logo paths resolve relative to config directory

3.0.2

March 21, 2026

Added

Geist Mono as default monospace font

Changed

Config changes hot-reload in dev server

Fixed

Scroll offset calculation

3.0.1

March 21, 2026

Added

Doxygen C++ documentation via Moxygen integration
Command palette search (Cmd+K)
Google Fonts loading and font stack configuration

Fixed

Moxygen resolved from npm registry
TOC scroll tracking
Heading scroll offset

3.0.0

March 20, 2026

Added

Redesigned theme with new layout, typography, and colour system
Theme presets (default, minimal, api-first) with custom colours, fonts, and layout
EndpointBar component with colour-coded method badges
CopyButton and SocialIcon UI components
Demo site with markdown guides
Unified Vite plugin for dev server

Changed

Renamed from spectacle-docs to sourcey
License changed from MIT to AGPL-3.0-only
Complete redesign of Header, Sidebar, Page, TableOfContents, CodeSamples, Responses, and Security components

Removed