> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.
---
title: "Changelog"
description: "Release notes for Changelog."
mode: "center"
---
import _ChangelogIntro from './changelog/intro.mdx'
import { HeroSection } from '../components/hero-section.tsx'
What's new in Holocron. All releases are published on [GitHub](https://github.com/remorses/holocron/releases).
## @holocron.so/vite\@0.21.0
1. **Standalone ChatWidget with shadow DOM isolation** — the AI chat component is now available as a drop-in widget via `@holocron.so/vite/chat`. It renders inside a shadow DOM host so styles don't leak in or out. Supports a `theme` prop (`'light'` | `'dark'` | `'auto'`), a zustand-based `useChatWidget()` hook for programmatic control, and works outside of holocron sites as a standalone component.
2. **GitHub star count in navbar and footer** — links pointing to GitHub repos now automatically show the star count (e.g. "3.6k stars"). Stars are fetched server-side with a 3-layer cache (in-memory 1h, Cloudflare Cache API 1h, GitHub API fallback) and streamed to the client via RSC so the page renders instantly without blocking.
3. **Broken asset detection at build time** — local image, video, and audio references in MDX are validated during the build. Missing files produce warnings with page source and line number. Covers markdown images, JSX ``, ``, `
## @holocron.so/cli\@0.17.0
1. **New `holocron subscribe` command** — subscribe a project to Holocron Pro directly from the CLI. Opens Stripe Checkout in the browser. Prompts interactively for project and billing interval when flags are omitted:
```bash
# Interactive mode
holocron subscribe
# Non-interactive
holocron subscribe --project --interval yearly
```
If the project already has an active subscription, opens the Stripe billing portal instead.
2. **New `holocron subscription status` command** — check the current subscription state for a project. Works with both session auth and API key auth (`HOLOCRON_KEY`):
```bash
holocron subscription status --project
```
## @holocron.so/cli\@0.16.0
1. **New `--base-path` flag for `holocron deploy`** — deploy your docs at a subpath on your own domain instead of a separate subdomain:
```bash
npx -y @holocron.so/cli deploy --base-path /docs
```
The flag sets Vite's `base` option at build time so all routes and assets are prefixed under the given path. Configure a rewrite or reverse proxy in your framework to forward `/docs/*` requests to the deployed holocron.so URL. Requires a Holocron Pro subscription.
2. **Fixed device flow login on some servers** — the poll response body was being read twice (once for success check, once for error handling). The second read silently failed, masking expired-token and access-denied errors.
3. **Allow `holocron login` from AI agent contexts** — removed the `isAgent` guard that blocked login inside agent terminals. The device flow only needs a browser, not interactive stdin.
4. **Removed `dotenv` dependency** — the CLI gets `HOLOCRON_KEY` from CI env vars or sigillo, not `.env` files, so dotenv was unnecessary.
## @holocron.so/vite\@0.20.0
1. **Auto-generate `` from page body text** — pages without an explicit `description` in YAML frontmatter now get a meta description extracted from the first paragraphs of the MDX content, truncated at \~160 characters on a word boundary. Headings, code blocks, and JSX elements are skipped. Frontmatter `description` always takes precedence.
2. **Resolve relative MDX links to absolute paths at build time** — relative markdown links like `[guide](./getting-started)` are now resolved to absolute paths during the build so they work correctly regardless of the page's nesting depth. The `.md` and `.mdx` extensions are stripped automatically.
3. **Subpath hosting support** — when deploying with `--base-path /docs`, the Vite plugin reads `HOLOCRON_BASE_PATH` at build time and injects it as Vite's `base` config, so all routes and assets get the subpath prefix without touching the user's `vite.config.ts`.
4. **AI chat drawer improvements** — the sidebar AI widget now morphs into the full chat drawer using the View Transitions API with blur cross-fade. Copy/regenerate footer buttons appear on all assistant messages, and the footer visibility gap between submitting a prompt and receiving a response is fixed.
5. **Fixed `VideoBackgroundShader` crash from culled `texelSize` uniform** — on GPUs that strip inactive uniforms during shader linking, the splat program threw "Unknown uniform: texelSize". The splat program is now excluded from the `texelSize` setup loop since its fragment shader never uses it. Thanks @skeptrunedev for #99!
6. **Fixed inlined MDX imports with overlapping export/import paths** — when an imported `.mdx` partial contained both an exported string constant and an import with the same relative path, only the actual import source is rewritten now.
7. **Fixed base path link collision** — replaced spiceflow's built-in `Link` with the holocron wrapper in components that were still using it, preventing broken links when the Vite `base` path collides with a page slug prefix.
## @holocron.so/vite\@0.19.0
1. **MCP documentation tabs** — auto-generate documentation pages from MCP (Model Context Protocol) definitions. Point a tab at a local JSON file or a remote Streamable HTTP MCP server:
```jsonc
{
"tab": "MCP",
"mcp": "mcp-tools.json",
"base": "mcp"
}
```
Each tool becomes a page with its input schema rendered as a parameter field list and a sampled JSON-RPC request example in the sidebar. Resources get their own pages with URI and MIME type. Supports selective mode with `"..."` rest expansion to interleave custom MDX pages with auto-generated ones, same as OpenAPI tabs.
2. **Changelog `initialContent` field** — prepend custom MDX content above auto-generated release entries in changelog tabs:
```jsonc
{
"tab": "Changelog",
"changelog": "https://github.com/owner/repo",
"initialContent": "changelog/intro"
}
```
The referenced file goes through the same URL rewriting pipeline as inline `.md` imports, so relative image paths and links resolve correctly.
3. **OpenAPI multi-status response examples** — the Response panel now shows examples for every response status, not just the first 2xx. When multiple statuses have examples, tab titles are prefixed with the status code for clarity. Closes #98
4. **OpenAPI spec HMR** — editing a local `.yaml` or `.json` OpenAPI spec now triggers an automatic re-sync so API reference pages update without restarting the dev server.
5. **VideoBackgroundShader MDX component** — a WebGL-powered dotted video background available directly in MDX as ``. Supports `dotStyle="ascii"` for an ASCII character atlas effect, configurable dot size, color, and fade gradients.
6. **Same-origin absolute URLs treated as internal links** — absolute URLs pointing to the same site now use client-side routing instead of full page reloads.
7. **Stripped HTTP method from OpenAPI sidebar labels** — the sidebar already shows a colored method badge, so the text label now omits the method to avoid redundancy.
8. **Fixed nested list spacing** — nested lists inside `
` elements are properly spaced.
9. **Fixed duplicate title in code blocks inside Tabs** — code blocks inside `` no longer show the panel title twice.
10. **Fixed HMR race condition** — concurrent `syncNavigation` calls during rapid file saves are serialized, preventing interleaved state corruption.
11. **Fixed AI widget aside overlap** — the synthetic AI chat aside only uses `full` mode when the page has no other asides.
12. **Fixed query string/hash preservation on redirects** — root and markdown-index redirects carry through query parameters and hash fragments.
13. **Fixed sidebar layout shift** — removed font weight change on active sidebar items.
14. **Fixed AI chat drawer close behavior** — the chat drawer closes on any link click, not just pathname changes.
## @holocron.so/vite\@0.18.2
1. **Fixed false broken link warnings for imported files outside pagesDir** — when a markdown file outside `pagesDir` (e.g., a repo-root `README.md`) is imported into a page and contains relative links back to pages, those links are now correctly resolved to absolute slug paths instead of raw filesystem-relative paths.
Previously all relative links in such imported files showed as broken even when the target page existed. For example, a `README.md` at the repo root imported via `import Readme from '../../README.md'` that contains `[OpenAPI](./website/src/openapi.md)` now resolves to `/openapi` instead of the unresolvable `../../website/src/openapi`. Hash fragments and query strings are preserved.
## @holocron.so/vite\@0.18.1
1. **Restored `motion` as optional dependency** — `motion` was accidentally removed in 0.18.0. Added it back so user projects that depend on it don't break on install.
## @holocron.so/vite\@0.18.0
1. **Build summary with actionable tips** — after all individual warnings are logged, the build now prints a final summary:
```
▲ holocron found 3 invalid internal links across 2 pages.
▲ holocron 2 pages with MDX errors. Fix the syntax issues listed above.
```
The broken links summary includes a link to the docs page explaining `knownPaths`.
2. **`HOLOCRON_TOKEN` accepted as env var alias for `HOLOCRON_KEY`** — the Vite plugin, deploy command, and AI chat auth now check both `HOLOCRON_TOKEN` and `HOLOCRON_KEY` (first defined wins). Useful when your CI already has a `HOLOCRON_TOKEN` secret.
3. **Fixed OpenAPI renderer CJS crash in dev** — `render-openapi.tsx` was incorrectly marked `'use client'`, pulling `safe-mdx` and its transitive chain into the client bundle. The `format` package (CJS-only) caused:
```
The requested module "format/format.js" does not provide an export named "default"
```
The fix removes the `'use client'` directive so the OpenAPI renderer stays server-side.
4. **Trimmed Prism syntax highlighting bundle (891 KB -> 471 KB)** — removed \~170 obscure languages, keeping \~130 popular ones. If you need a removed language, open an issue.
5. **Deduplicated acorn in RSC bundle (180 KB saved)** — a resolve alias now forces all acorn imports to the ESM entry, eliminating the CJS+ESM duplication. RSC bundle: 3,998 KB -> 3,818 KB.
6. **Removed dead dependencies** — dropped `@fastify/deepmerge`, `image-size`, and `motion` from the package.
## @holocron.so/cli\@0.15.1
1. **`HOLOCRON_TOKEN` accepted as env var alias for `HOLOCRON_KEY`** — deploy and all API commands now check both `HOLOCRON_TOKEN` and `HOLOCRON_KEY` (first defined wins). Useful when your CI already has a `HOLOCRON_TOKEN` secret and you don't want to rename it.
## @holocron.so/vite\@0.17.1
1. **Fixed OpenAPI double-framed code panels** — when an operation defined multiple named request body or response examples, `RequestExample` and `ResponseExample` wrapped them in a `CodeGroup` inside a `CodeCard`, producing a double frame. Now they render as a single tabbed panel with each example as a named tab.
2. **Fixed app entry CSS crash without the Vite plugin** — importing `@holocron.so/vite/app` outside the holocron Vite plugin (e.g. inside a `@cloudflare/vitest-pool-workers` test running in workerd) crashed with `Cannot find module './styles/globals.css'`. The import now resolves from the package `src/` directory which is stable from both `src/` and `dist/`.
3. **Hidden tab scrollbars and press feedback** — the horizontal tab scroll container no longer shows a scrollbar on overflow, and tab buttons no longer flash a press/active highlight.
## @holocron.so/vite\@0.17.0
1. **Changelog tab generated from GitHub releases** — add a tab with a `changelog` URL and Holocron fetches the repository's published releases at build time, rendering one page with a Mintlify-compatible `` entry per release (newest first, drafts skipped):
```jsonc
{
"tab": "Changelog",
"changelog": "https://github.com/owner/repo"
}
```
The generated page uses `mode: center` (left nav hidden) with a right-side notice explaining it's generated from GitHub releases. Release notes are Markdown and are safely escaped so a release body can never break the page. Set a `GITHUB_TOKEN` / `GH_TOKEN` to avoid rate limits; the token is only ever sent to `api.github.com`. Transient GitHub outages render a warning page instead of failing the build.
2. **Page mode frontmatter (`mode: center`)** — hide the left navigation sidebar per-page, matching Mintlify's `mode` layout control:
```mdx
---
title: Landing
mode: center
---
```
Holocron collapses Mintlify's five mode values into two real layouts: `default` / `wide` / `frame` keep the left nav; `center` / `custom` hide it and center the content. All five names are accepted so existing Mintlify frontmatter works unchanged.
3. **Static page prerendering with `rendering: static`** — opt a page into build-time prerendering. Static pages render to HTML + RSC data at build for faster delivery and cheaper hosting. Use it for pages whose content never depends on the incoming request:
```mdx
---
title: Overview
rendering: static
---
```
The default is `ssr`, which renders on every request so pages can react to per-request data like cookies.
4. **Multiple OpenAPI examples render as switchable tabs** — when an operation defines several named examples (the `examples` map), Holocron renders all of them as a tabbed code group instead of showing only the first. Example names become the tab labels:
```yaml
responses:
'201':
content:
application/json:
examples:
Confirmed order:
value: { id: 'order-001', status: 'pending' }
Empty order:
value: { id: 'order-002', items: [] }
```
5. **Markdown in OpenAPI descriptions** — `description` fields (Markdown by spec) now render as formatted HTML — headings, lists, inline code, links, emphasis, code blocks — everywhere they appear: endpoint summary, parameters, schema properties, request bodies, and responses. The page `` description is still flattened to clean plain text. (Closes #96)
6. **Mix MDX pages with endpoint pages in OpenAPI tabs** — an API Reference tab can now interleave hand-written MDX pages (overviews, authentication guides) with auto-generated endpoint pages.
7. **`/index` paths resolve to their canonical href** — the `*/index` forms now 308-redirect to the canonical href at runtime (query strings preserved) and count as valid targets for broken-link detection, so links to `/guide/index` no longer 404 or get flagged as broken.
8. **New `@holocron.so/vite/prism` export** — reuse Holocron's vendored Prism bundle (prismjs core + \~300 grammars in one ESM module) to highlight code outside MDX, without shipping a duplicate bundle:
```tsx
import { Prism } from '@holocron.so/vite/prism'
const html = Prism.highlight(code, Prism.languages[lang], lang)
```
9. **`bleed` prop on CodeBlock accepts `'both' | 'right' | 'none'`** — control how a code block bleeds into the page margins. `'both'` (or `true`) bleeds both sides, `'right'` only the right margin, `'none'` (or `false`) stays inside the parent.
10. **Scroll-driven fade mask on the left navigation sidebar** — the sidebar top/bottom edges fade as you scroll.
11. **Collapsible TOC headings in the left sidebar** — nested headings can now collapse and expand.
12. **Broken link validation runs during builds** — links pointing to non-existent pages are reported at build time.
13. **`base` slug prefix accepts a leading slash** — the `base` field on OpenAPI and Changelog tabs is a slug prefix, so a leading slash is now allowed and ignored (`"/docs/api"` behaves like `"docs/api"`); trailing slashes are trimmed. The field was renamed from `openapiBase` to `base` and is now shared across virtual-tab providers.
14. **`` hero spans the full grid width** including the side rails.
15. **Restyled inline code pills** — GitHub-style with baseline alignment; body prose softened so bold text and headings stand out at full foreground color.
16. **Seamless HMR for `globals.css` edits** — editing Holocron's global stylesheet hot-reloads without a full page refresh.
17. **Skip auto H1 injection for non-default page modes and JSX-first pages.**
18. **Fixed per-section asides scoped on heading-first pages.**
19. **Updated spiceflow to 1.26.0-rsc.3**
## @holocron.so/cli\@0.15.0
1. **Clear deploy error when a subscription is required** — when a deploy exceeds the free plan (a preview deploy, or a 2nd production deploy on the free tier), the server returns a `SUBSCRIPTION_REQUIRED` error. The CLI now surfaces the server's actionable message plus the upgrade URL instead of a generic `Failed to create deployment`:
```bash
npx -y @holocron.so/cli deploy
# A Holocron Pro subscription is required for this deployment.
# Subscribe to continue: https://holocron.so/...
```
2. **Clearer expired-session message on `login`** — when a saved session token is expired or invalid, the CLI now tells you to run the login command again instead of failing with a confusing error.
3. **Updated spiceflow to 1.26.0-rsc.3**
## @holocron.so/vite\@0.16.0
1. **New `@holocron.so/vite/mdx` export** — import Holocron MDX components in your own `.tsx` files:
```tsx
import { Card, CardGroup, Callout, Steps, Step } from '@holocron.so/vite/mdx'
```
Useful when building custom components that compose Holocron primitives. In MDX pages, all components remain available globally without imports.
2. **Image processing preserves user-specified dimensions** — when you set `width` or `height` on `` or `` in MDX, those values are now preserved instead of being overridden with the natural image size. When only one dimension is provided, the other is computed proportionally from the aspect ratio.
3. **SVG images skip placeholder generation** — SVG files no longer get a pixelated 16px rasterized WebP placeholder since SVGs are vector and render instantly.
4. **Fixed images in flex containers** — images inside `
## @holocron.so/vite\@0.15.0
1. **Keyboard shortcut `d` to toggle dark mode** — press `d` anywhere on the page to switch between light and dark mode. Skips when focus is in an input, textarea, or contenteditable, and ignores modifier combos (Cmd+D, Ctrl+D, etc.)
2. **Styled `
` for plain MDX** — standard markdown `> quoted text` now renders with a left border accent and italic muted text. GitHub-style callouts (`> [!NOTE]`, etc.) still render as Callout components
3. **New `--type-nav-group-size` CSS variable** — controls font-size of sidebar group titles. Override it to customize sidebar typography:
```css
:root {
--type-nav-group-size: 14px;
}
```
4. **Smarter AI chat assistant** — gives shorter, messenger-style answers. Prefers linking to docs pages over re-explaining content
5. **Fixed ai-logo proxy crash in Dynamic Workers** — `caches.open()` could throw in hosted environments where Cache API is unavailable, causing a 500. Now falls back to direct fetch
6. **Fixed theme shortcut firing during input** — components that call `preventDefault()` no longer accidentally trigger the dark mode toggle
7. **Removed paragraph opacity 0.82** — body text no longer renders at reduced opacity
8. **Fixed subpath externalization in client builds** — `addNoExternal` for `@holocron.so/vite` now runs in all Vite environments (client, ssr, rsc)
9. **Updated spiceflow to 1.26.0-rsc.0**
## @holocron.so/cli\@0.14.1
1. **Updated spiceflow to 1.26.0-rsc.0**
## @holocron.so/vite\@0.14.3
1. **Fixed spiceflow resolution in strict pnpm workspaces** — spiceflow is a transitive dep of `@holocron.so/vite` and not hoisted in strict pnpm. Virtual modules like `virtual:app-entry` can't resolve bare `spiceflow` imports because they have no filesystem location. A `resolveId` hook now resolves spiceflow from holocron's own source directory.
2. **Logo text uses heading font** — navbar logo text now uses the configured heading font-family at 22px with weight 560 and tighter letter-spacing.
3. **Removed preserveSymlinks resolver** — eliminated the custom `@holocron.so/vite/src/*` resolveId hook that was only needed when spiceflow was a workspace dependency.
4. **Updated spiceflow to 1.25.4-rsc.0**
## @holocron.so/vite\@0.14.2
1. **Logo text uses heading font** — the logo text in the navbar now renders with the configured heading font-family, heavier weight (560), and tighter letter-spacing at 22px, matching the editorial heading style.
2. **Removed preserveSymlinks resolver** — eliminated custom `resolveId` hooks for `spiceflow` and `@holocron.so/vite/src/*` that were only needed when spiceflow was a workspace dependency. Vite's default resolution now handles everything correctly, fixing transitive dep resolution in strict pnpm workspaces.
3. **Updated spiceflow to 1.25.4-rsc.0**
## @holocron.so/vite\@0.14.1
1. **DialKit config panel persists open/closed state** — the config panel no longer resets to its default state on page refresh or RSC remount. Open/closed state is saved to localStorage so the panel stays how you left it.
2. **Reduced main bundle size** — DialKit is now fully lazy-loaded. A stray value import was pulling the entire dialkit package into the eager bundle; switching to `import type` ensures it only loads when the config panel is opened.
## @holocron.so/cli\@0.14.0
1. **Rich `whoami` command with multi-org support** — `holocron whoami` now shows your user info, all organizations with IDs and roles, and projects grouped per org:
```bash
npx -y @holocron.so/cli whoami
```
2. **Multi-org project creation** — `holocron projects create` accepts `--org [orgId]` to target a specific organization. When you belong to multiple orgs and no `--org` is passed, an interactive picker appears.
3. **Deploy project picker shows org names** — when deploying with multiple projects across orgs, the interactive picker now displays the org name alongside each project.
Thanks @tanishqkancharla for directing most of the UI changes!
## @holocron.so/vite\@0.14.0
1. **Analytics integrations for 14 providers** — new `integrations` field in docs.json injects client-side analytics scripts. Supports Fathom, Plausible, Pirsch, GA4, GTM, PostHog, Mixpanel, Hotjar, Heap, Segment, Clarity, Amplitude, LogRocket, and Clearbit:
```json
{
"integrations": {
"ga4": { "measurementId": "G-XXXXXXXXXX" },
"plausible": { "domain": "docs.example.com" },
"fathom": { "siteId": "ABCDEF" }
}
}
```
2. **New `
## @holocron.so/cli\@0.13.0
1. **New `--key` option for `holocron create`** — pass an existing API key to skip the entire cloud setup flow (no device flow login, no project creation, no API key creation). The key is written directly to `.env`:
```bash
npx -y @holocron.so/cli create my-docs --key holo_xxxxxxxxxxxx
```
This enables one-step scaffolding when the key is already known, e.g. from the holocron.so dashboard.
## @holocron.so/vite\@0.13.0
1. **Anchor placement in tabs or sidebar** — anchors now support a `placement` field that controls where they render. `"sidebar"` (the new default) places anchors at the top of the left navigation sidebar with icon and label. `"tabs"` places them in the header tab bar, preserving the previous behavior. You can mix both placements in the same config:
```json
{
"navbar": {
"links": [
{ "label": "GitHub", "url": "https://github.com/...", "placement": "sidebar" },
{ "label": "Changelog", "url": "/changelog", "placement": "tabs" }
]
}
}
```
2. **Copy-to-clipboard button on code blocks** — every fenced code block now shows a copy button on hover in the top-right corner. The button fades in, transitions to a checkmark icon on success, and gracefully handles clipboard write failures in insecure contexts.
3. **`.md`/`.mdx` extensions stripped from internal links** — links like `[guide](/getting-started.md)` are now automatically rewritten to `/getting-started` at build time. Previously these links were excluded from broken-link validation and would serve raw markdown or 404. Reference-style links and JSX `href` attributes are also handled.
4. **Dark mode persists across reloads** — a blocking `