Skip to content

docmd@0.8.13 🩹 (Patch Fix)

Choose a tag to compare

@mgks mgks released this 13 Jul 21:34
ff517eb

docmd logo

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