In this episode, co-founders Boris and Geoff recap last month's feature releases.
Episode highlights:
- Ask AI straight from search. Start typing in search, then hand your question to the AI chat instead of opening a result — press ⌘/Ctrl+Enter or click Ask AI in the search footer. The question is appended to your chat conversation so you can keep a thread going, and plain Enter still jumps to the top result. AI Chat →
- Copy answers and transcripts. Every AI chat answer has a copy button that grabs the Markdown source, and a Copy transcript action in the chat header copies the whole conversation as role-labeled Markdown — handy for pasting into an issue or a doc. AI Chat →
- Smarter chat auto-scroll. The chat only follows a streaming answer when you're already at the bottom. Scroll up to re-read an earlier reply and it stays put instead of yanking you down; scroll back to the bottom and it re-pins.
- Custom CSS in local preview (CLI). jamdesk dev applies your custom CSS the same way the published build does, so you can check styling before deploying. Drop any .css file in your project root — style.css, or several combined alphabetically — and it loads on browser refresh. No docs.json entry needed, matching how Mintlify includes root stylesheets. Custom CSS →
- Custom social previews from frontmatter. Set any Open Graph or Twitter/X meta tag directly in a page's frontmatter — og:title, og:description, og:image, twitter:card, keywords, and the full metatag set. Use flat top-level keys or a nested seo: block; both work, and per-page values override your docs.json defaults. SEO →
- Hidden pages. Keep drafts, internal handbooks, or deprecated guides out of your sidebar and search results without deleting them. Add hidden: true to a page's frontmatter, or to a group or tab in docs.json. Hidden pages stay reachable by direct URL but disappear from navigation, sitemap, on-site search, and AI context — and pick up an automatic noindex tag. Need a hidden group whose pages still rank in search? Add searchable: true alongside hidden. Hidden pages →
- Grid and windows decorations. Two new background patterns join the Jam theme's gradient default. Set background.decoration to "grid" for a subtle 24px dot grid, or "windows" for two Windows 11–style frosted spots in the upper corners. The gradient and "none" flat fill still work as before — pick the look that fits your brand. Background →
- Background customization. A new background block in docs.json disables the Jam light-mode gradient, overrides the page color per mode, or tunes the gradient's color, size, position, and opacity. No custom CSS needed. Background →
- D2 Diagrams. A second diagram language joins Mermaid. Tag a fenced code block d2 and Jamdesk renders it as a build-time SVG, with light and dark themes baked in. Same workflow as Mermaid — pick whichever language fits the diagram you're drawing. D2 Diagrams →
- Grouped search results. Search no longer repeats the same page for every section match. Hits bucket under their parent page in the search modal, with up to three sections visible by default and an inline expander for the rest. Snippet highlighting stays put — you find the right section in fewer scans.
- Auto-detect docs.json on connect. Connecting a GitHub repo finds your docs.json wherever it lives. The connect flow scans the whole tree and flags a Mintlify mint.json if it stumbles on one instead. Monorepos and nested configs work with no manual setup. Connecting GitHub →
- docs.json location hints in the CLI. Misplaced configs are easier to spot. jamdesk validate, jamdesk dev, and jamdesk doctor report where your docs.json actually is — or where it should go — instead of a generic "not found" error. Fix it in seconds instead of decoding a stack trace. CLI overview →
What is The API Docs Podcast?
The founders of Jamdesk run through all the new updates of Jamdesk.