Changelog

New features

• Compare view — a new Compare option sits alongside Visual and Source when you're editing on a branch in docs-as-code mode. It shows your draft side-by-side against the published version, with modified, added, and removed blocks highlighted. Use the arrows to jump between changes, toggle Changes only to hide unchanged content, and click Restore on any change to revert that block to its published state. Restores support undo/redo with Cmd/Ctrl+Z. See Compare view.
• Branch change marks — the Navigation and Files tabs now show a colored letter (A, M, or D) next to any file that has been added, modified, or deleted on the current branch compared to what's published. A dot on a group or folder signals changes inside it. Hover for a tooltip. See Branch change marks.
• Collapsible left panel — click the collapse icon to hide the Navigation / Files / Config panel and give your writing more screen space. Click the icon on the left edge to bring it back.

Improvements

• The authentication settings UI now only shows the methods available on your plan. Free shows Password; Begin and Value show Password and Workspace; Enterprise shows all four (Password, Workspace, OAuth 2.0, JWT). If an option is not visible, your plan does not include it.

Added

• Personalized content — shared session on public sites, MDX {user} fields, Try It prefills, and OpenAPI x-velu group filtering. Value plan. Mutually exclusive with private authentication.

Added

• Preview deployments — unique live URLs for each pull request and branch, isolated from production. Available on Begin and Value.

Added

• Readers can report an issue on a published code example. Those reports show up in dashboard Feedback.

Added

• Authentication setup — password, workspace, OAuth 2.0, and JWT for private documentation, plus public pages and group access

Added

• Velu REST API — trigger deployments, search published docs, and embed Ask AI with an API key

Added

• Generated OpenAPI pages can include extra MDX at the same path — the playground first, then your prose, then Path, Body, and Response
• velu dev reloads generated API pages when the OpenAPI spec changes
• Hosted private docs: per-group public and per-page access control

Added

• Theme cards can now show separate illustrations for light and dark mode — add imgLight and imgDark alongside img
• Card action links pin to the bottom, so side-by-side cards stay aligned

Fixed

• The default theme header shows the Velu brand mark next to the site name when no custom logo is configured

Added

• Kadhir theme refinements: sticky slim rail, transparent active states, and a round assistant entry button

Fixed

• Site logos now load reliably in all browsers
• "Powered by Velu" credits show the brand mark

Added

• Kadhir theme — set "theme": "kadhir" for a slim icon rail with tooltips and section dividers

Added

• Nila theme — set "theme": "nila" for a compact header, grouped sidebar, and a focused reading column

Added

• Aalam theme — set "theme": "aalam" for branding, search, and navigation in the left sidebar, with tabs above the article

Added

• Thulir theme — set "theme": "thulir" for an open layout with Inter typography, teal accents, and a compact previous/next footer

Fixed

• Horizontal trackpad scroll no longer moves sticky chrome (header, sidebars)
• Site footer optical center matches the article column (accounts for the left nav, not the full viewport)
• Left nav stays full height beside the footer, with an always-visible scrollbar and no edge fade arrows

Added

• Vepa theme — set "theme": "vepa" for denser docs chrome

Added

• Page modes — set mode in frontmatter to default, wide, custom, frame, center, or assistant
• Custom CSS and JS from the project root are included on every page

Added

• Private docs: generate a login gate from config and keep requests under the site base path

Fixed

• Prerender no longer crashes when Ask AI uses __VELU_SAME_ORIGIN__
• Login mark and wordmark stay on one row

Fixed

• Ask AI links no longer double-prefix /docs on subpath sites
• The mobile drawer and Ask AI sheet close on navigation