docmd@0.8.13 🩹 (Patch Fix)
Auto Install Packages + URL Logic Fix
✨ The generator now centrally manages the base tag (except in offline mode). Auto-install retry now bypasses Node's stale module cache, improving reliability on Linux and CI.
Highlights
- Fixed the
<base>tag logic for GitHub Pages, offline builds, and asset loading. - Fixed auto-install reliability for templates and semantic search dependencies on Linux and CI.
- Search now displays a clear message when opened via
file://instead of a misleading error. - Various test runner and linting improvements.
Base URL & Offline Fixes
The <base> tag logic has been centralised in the generator, making it the single source of truth.
This resolves:
- GitHub Pages subpath asset loading (
#175) - Offline HTML link resolution (
#167) - Offline CSS and asset loading (
#177)
Templates no longer emit their own <base> tags. The generator now automatically chooses the correct behaviour for root deployments, GitHub Pages, and offline builds.
Auto-install Improvements
Improved the reliability of automatic dependency installation for templates and optional packages such as @docmd/template-summer and docmd-search.
The installer now bypasses Node's stale module resolution cache when retrying newly installed packages, preventing intermittent failures on Linux and CI environments.
Also added support for the DOCMD_INSTALL_VERSION environment variable to override the version used during automatic installs.
Offline Search
Search now detects when a site is opened directly via file:// and displays a helpful message explaining that browsers block fetch() from local files.
Instead of reporting a failed search index, users are guided to serve the site over HTTP for search functionality.
Thanks 💖
Thanks to all contributors and community members who reported issues and provided feedback.
Documentation: https://docs.docmd.io/
GitHub: https://github.com/docmd-io/docmd
Semantic Search (docmd-search): https://github.com/docmd-io/docmd-search
Skills: https://github.com/docmd-io/docmd-skills
Full Changelog: 0.8.12...0.8.13
