Release on OINK

Release 0.16.0 report and upgrade guide

Wed, 29 Jul 2026 00:00:00 +0000

Highlights

First-class npm support: install Docsy from the registry, and more
Favicons: drop your icons into static/ and Docsy does the rest
Shared chrome (experimental): a build mode for much faster link checking of large sites
Agent-ready upgrade guide: hand this post to your AI assistant

Release summary

Packaging modernization:
- Theme folder move: a one-line path update per install mode
- Hugo modules now source Bootstrap and Font Awesome via npm
- PostCSS now opt-in for non-RTL sites
- Docsy on the npm registry: the new @docsy/theme package
Minimum Hugo raised to 0.160.1: was 0.146.0
New features:
- Favicon discovery from static/
- Shared chrome build mode (experimental)
Other notable changes, and for maintainers: repository package layout, and build and test guards

Ready to upgrade?

⚠️ Respect the order of steps to avoid breaking your build.
Review BREAKING changes:
Review the companion Hugo 0.158+ upgrade guide if your site is not already building cleanly with Hugo 0.164.0.
Optionally skim:
- Docsy on the npm registry
- Favicon discovery
- Experimental shared chrome build mode
- PostCSS is opt-in for non-RTL sites
- Other notable changes, and for maintainers
Jump to Upgrade to 0.16.0 yourself, or ask an AI agent.

/ Theme folder move

Docsy’s canonical theme tree has moved from the repository root to theme/. This is the main structural change in 0.16.0.

Release 0.15.0 report and upgrade guide

Fri, 01 May 2026 00:00:00 +0000

Highlights

Agent support: llms.txt, Markdown page output, and a “View Markdown” page-meta link
Doc-rooted sites: improved support for publishing docs at the site root
Version menus: richer entries and updated navbar rendering

Release summary

Agent support (experimental):
- Generated llms.txt
- Markdown page output
- “View Markdown” page-meta link
Doc-rooted sites (experimental): documented pattern and example variant for sites whose docs section is published at the site root
Version menu entries: headings, separators, per-entry page-link behavior, and kind-specific styling
Content, shortcodes, and internationalization:
- Community and footer links
- card shortcode rendering
- Internationalization additions and updates

Ready to Upgrade?

Review BREAKING changes:
- Community and footer links
- Version menu entries
- Card shortcode rendering (low risk)
Optionally skim:
- New features (look for the green checkmark icon)
- Cleanup / improvement opportunities (look for this icon)
- Other notable changes
Jump to Upgrade to 0.15.0 once you are ready

Agent support

Release 0.15.0 includes the phase 1 implementation of agent support, which provides opt-in features that help AI agents and automated tools discover and use your site content, including:

Release 0.14.0 report and upgrade guide

Tue, 10 Feb 2026 00:00:00 +0000

Patch updates 0.14.1 to 0.14.3

For the key fixes of these patch updates, see 0.14.1, 0.14.2, and 0.14.3. For other changes to 0.14.2, see Patch update 0.14.2. If you are upgrading now, follow this guide and use 0.14.3 where it references 0.14.0.

Highlights

Styles and customization: navbar improvements, reorganized SCSS files
Content and localization: new Markdown alert syntax and internationalization improvements
Hugo 0.155.0 requirement, and 0.153+ breaking and notable changes

Release 0.13.0 report and upgrade guide

Mon, 24 Nov 2025 00:00:00 +0000

Highlights

Docsy 0.13.0 includes the most upvoted enhancement request of 2025, and more.
This release has new features and only minor breaking changes.¹
Read about our experiences using AI to upgrade Docsy projects.

Release summary

Docsy 0.13.0 comes with the following notable features and fixes:

Navigation and UX improvements including the most upvoted enhancement request of 2025: Active TOC entry tracking (#349, #2289)
Alert shortcode rewrite for better Markdown support
Accessibility enhancements for better color contrast and dark mode support

Ready to upgrade?

Review BREAKING changes:
- Alert shortcode body content processing changes
- Language menu visibility changes
Optionally skim:
- New features
- Other notable changes
Jump to Upgrade to 0.13.0 once you are ready.

Active TOC entry tracking

Docsy 0.13.0 introduces active table of contents (TOC) entry tracking, the most upvoted enhancement request of 2025. This feature highlights the TOC entry corresponding to the page’s section that is currently in view. The feature is implemented using (a patched version of) Bootstrap’s ScrollSpy. The new default TOC labels “On this page” and “Top of page” are localizable. For details, see Active TOC entry tracking with ScrollSpy.

Release on OINK

Release 0.16.0 report and upgrade guide

Release summary

Ready to upgrade?

/ Theme folder move

Release 0.15.0 report and upgrade guide

Release summary

Ready to Upgrade?

Agent support

Release 0.14.0 report and upgrade guide

Release 0.13.0 report and upgrade guide

Release summary

Ready to upgrade?

Navigation and UX improvements

Active TOC entry tracking