--- title: Changelog description: What's new in Jamdesk, the docs-as-code platform for MDX, GitHub, and API documentation. Feature releases, CLI updates, and platform changes. rss: true --- New features, platform changes, and CLI updates for Jamdesk. **Auto-detect `docs.json` on connect.** Connecting a GitHub repo now scans the whole tree for your `docs.json`, and flags a Mintlify `mint.json` if it finds one instead. A config in a subdirectory or monorepo path works with no manual setup, and detection errors appear on the Connect card instead of buried in a build log. [Connecting GitHub →](/setup/connecting-github) **`docs.json` location hints in the CLI.** `jamdesk validate`, `jamdesk dev`, and `jamdesk doctor` now report where your `docs.json` actually is, or where it should go, when they can't find it. You fix a misplaced or nested config in seconds instead of decoding a generic error, which is the common case in monorepos and mid-migration. [CLI overview →](/cli/overview) **Standards-compliant hreflang for multi-language sites.** Hreflang tags now emit valid BCP 47 codes, so locale folders like `cn`, `jp`, or `ja-jp` map to the `zh` and `ja` codes search engines expect, with sitemap URLs XML-escaped. Crawlers read your language alternates correctly, so every localized page ranks in its own region instead of being treated as duplicate content. [Languages →](/setup/languages) **PDF Export.** Render your whole docs site to a single [PDF](/builds/pdf-export) from **Settings → PDF Exports** in the dashboard. Paid plans only. Multi-language projects pick a locale per export, results are cached per commit, and you get an email with a download link when rendering finishes. **Multi-language OpenAPI Specs.** Endpoint pages now render translated OpenAPI specs alongside translated MDX. Drop a `..` file (e.g., `openapi/api.fr.yaml`) next to your source spec and Jamdesk picks it up on that language's URLs, falling back to the English spec when a language variant is missing. Operation summaries, parameter descriptions, response descriptions, and schema descriptions all localize. Setup: [Translating OpenAPI Specs](/setup/languages#translating-openapi-specs). **Visibility Component.** New [``](/components/visibility) component lets you carve out content for human readers or AI agents on the same page. Human-only blocks render in the browser but are stripped from `.md` exports and `llms-full.txt`; agent-only blocks do the reverse. Agents requesting `Accept: text/markdown` on canonical URLs automatically get the agent view. **Password Protection, rebuilt.** You can now lock your whole site behind a shared password, or gate just a handful of pages while the rest stay public. Set `auth.password.enabled: true` for whole-site mode, or mark individual pages with `private: true` in frontmatter (or list them under `auth.password.private`) for specific-pages mode. The Settings page in the dashboard walks you through setting, rotating, and revoking the password. Visitors hit a branded unlock screen with your site's logo, primary color, and an optional hint you define in `docs.json`. Setup guide: [Password Protection](/setup/password-protection). **Automatic WebP Image Conversion.** Jamdesk can convert your PNG and JPG images to WebP at build time. Converted files are usually 60-80% smaller than the originals with no visible quality loss, so your pages load faster without any manual image processing. Opt in via `images.convertToWebp: true` in `docs.json`. Favicons, `og:image`, and `twitter:image` stay in their original format for social crawler compatibility. A new **Optimizing images** step shows live progress in the dashboard and CLI during each build. [Automatic Image Conversion →](/builds/image-optimization) **API Playground.** Endpoint pages now have an interactive ["Try it" button](/api-reference/playground). Fill in parameters, watch code examples update in real time, and send live requests without leaving your docs. Enabled by default on all API pages. Works with both OpenAPI and MDX-authored endpoints. **Claude Code Plugin.** Install the [Jamdesk plugin for Claude Code](/claude-code-plugin) to give Claude deep knowledge of MDX components, `docs.json` configuration, navigation patterns, and CLI commands. Two-step install from the plugin marketplace. Pairs with [CLAUDE.md](/ai/claude-code) and the [MCP server](/ai/mcp-server) for AI-assisted doc writing. **Build Warnings for Missing Branding.** Builds now warn when `favicon` or `logo` paths in `docs.json` reference files that don't exist in your project. Warnings appear in the dashboard build details and in the CLI via `jamdesk dev` and `jamdesk validate`. No email; the warning is informational only. **YouTube Shorts.** The [`` component](/content/youtube#youtube-shorts) now supports vertical Shorts via the `short` prop, rendering a centered 9:16 player with no black bars. Use ``. **AI Actions Menu.** A [dropdown on every page](/ai/ai-actions) lets readers copy Markdown, open the page in ChatGPT/Claude/Perplexity, grab the MCP server config, or one-click install it in Cursor or VS Code. Enabled by default; pick which options show up via `contextual` in `docs.json`. **Analytics.** Cookie-free page analytics tracking views, traffic sources, and visitor trends with [per-page breakdowns](/setup/project-analytics). No consent banner needed. Overview: [Analytics](/setup/analytics-overview). **Integrations.** [Google Analytics 4](/integrations/google-analytics), [Google Tag Manager](/integrations/google-tag-manager), [Plausible Analytics](/integrations/plausible-analytics), and [Slack build notifications](/integrations/slack) (Pro). **RSS Feed for Changelogs.** Pages with `rss: true` in frontmatter now auto-generate a subscribable RSS feed. An RSS icon appears next to the page title, and a `feed.xml` is built from your [Update](/components/update#rss-feed) components during each build. Use the new `date` prop on Update for proper feed dates. **CLI Login & Deploy.** [`jamdesk login`](/cli/authentication) authenticates via browser. [`jamdesk deploy`](/cli/deploy) packages your project and triggers a build from the terminal. No GitHub connection required. The CLI respects `.gitignore`, warns about secret files, and streams build progress inline. **CLI Spellcheck.** `jamdesk spellcheck` checks your documentation for spelling errors with 180+ built-in tech terms (English only). `jamdesk spellcheck --fix` launches an interactive mode to fix typos or add words to your ignore list. **Video Embeds.** Embed `.mp4` and `.webm` files directly in your docs. Drop them in a `/videos` directory and use markdown syntax (`![Demo](/videos/demo.mp4)`) or the [` **AI Chat.** Built-in [chat assistant](/ai/chat) on every docs site. Visitors ask questions and get answers with citation links back to source pages. Powered by Claude, enabled on all plans. **AI Integration.** Every site generates [`llms.txt`](/ai/llms-txt) for LLM context windows, exposes raw Markdown at [`.md` URLs](/ai/markdown-source), and includes an [MCP server](/ai/mcp-server) at `/_mcp` with `searchDocs` and `getPage` tools. Setup guides for [Claude Code](/ai/claude-code), [Cursor](/ai/cursor), and [Codex](/ai/codex). Also: [Writing with AI](/ai/writing-with-ai) and [Automated Updates](/ai/automated-updates). **CLI.** `jamdesk dev` for local preview with hot reload, `jamdesk validate` for broken links, `jamdesk migrate` to convert from Mintlify/GitBook/Docusaurus, `jamdesk doctor` for setup issues. Install via npm, curl, or Homebrew. [Full reference →](/cli/overview) **VS Code Extension.** [Start, stop, and restart the dev server](/development/vscode-extension) from the VS Code status bar, no terminal required. **Custom Domain TXT Verification.** All custom domains now require a TXT record (`_jamdesk.yourdomain.com`) before routing activates. This prevents domain takeover on unclaimed subdomains. Newly added domains will see the TXT record in the dashboard setup flow. See the [Custom Domains guide](/deploy/custom-domains). **Multi-Language Support.** Define [separate navigation trees and content directories per locale](/setup/languages). Readers switch languages from a dropdown in the top bar. **Search Analytics.** [What readers search for](/setup/search-analytics), which queries return nothing, and which results actually get clicked. Useful for finding content gaps. Jamdesk launches. Write docs in MDX, push to GitHub, get a site on a global CDN. Builds finish in under 60 seconds. **MDX & Components.** 20+ built-in components: tabs, accordions, steps, code groups, Mermaid diagrams, KaTeX math, and icons. Syntax highlighting with line numbers in [code blocks](/content/code-blocks). Build [custom React components](/content/react-components) with Tailwind and hooks, and reuse content with [snippets](/content/snippets). [Components Overview →](/components/overview) **OpenAPI Documentation.** Generate [API reference pages](/api-reference/openapi-example) from your OpenAPI spec via `api.openapi` in `docs.json`. **Deployment.** [Auto-deploy from GitHub](/how-jamdesk-works) on push with 10s debounce. [Custom domains](/deploy/custom-domains) with automatic SSL, [subpath hosting](/deploy/subpath-hosting) at `/docs` (Vercel, CloudFront, Cloudflare, nginx), and [monorepo support](/setup/monorepo-support). **Customization.** Three [themes](/customization/theming) (`jam`, `nebula`, `pulsar`) with custom colors, logos, and footer. [Custom CSS](/customization/custom-css) for style overrides. Flexible [navigation](/navigation/overview) with tabs, groups, and icons. [Redirects](/setup/redirects) with exact and wildcard matching. **Search & SEO.** Cmd+K full-text search, zero config. [Sitemaps, OG images, and per-page meta](/content/seo) out of the box. **[docs.json Reference](/config/docs-json-reference).** Complete configuration reference for all settings and options. **[Help Center](/help/overview).** Account management, billing, and troubleshooting guides. --- ## Stay Updated Detailed announcements and tutorials CLI release notes