Repository navigation
Releases
v0.2.0
molde verify, molde's output checks on any generator's build, and a GitHub Action that
runs check or verify on pull requests. Since 0.1.0:
Added
-
Templates get
page.title,page.descriptionandpage.index: the page's rendered
title and description patterns (the stringsstd_headprints) and itsindexvalue,
so a template can addtwitter:titleor a tag only on indexable pages without
repeating the route's patterns. Nothing to do. -
The check report's
pages_by_localeentries andi18n.sparse_localewarnings carry
the route'stemplateand, onforeachroutes,foreach(the collection) next to
route, so routes that share a path pattern can be told apart. Nothing to do. -
molde verify DIR: molde's output checks on any generator's build (Hugo, Astro, a
Next.js static export, Eleventy, Zola, or molde's ownout/current). It printscheck's
report shape pluscommand,pages,warningsandskipped, and exits 1 on an error.- Rules for foreign output: every file is classified (not-found pages, redirects and
aliases, noindex pages), and one URL model handles base paths, clean URLs and
<base href>. - New check ids:
links.outside_base,links.clean_urls,canonical.off_host,
canonical.target_missing,canonical.target_noindex,canonical.shared,redirect.target_missing,
sitemap.non_canonical_listed,sitemap.not_found,verify.base_url_mismatch,
verify.no_pages,verify.project_rootand the warningverify.all_noindex. - Release gate: each generator's official starter, committed in
tests/verify/fixtures. - See Verify any site.
molde checkis unchanged.
- Rules for foreign output: every file is classified (not-found pages, redirects and
-
A GitHub Action (
uses: ManuelFontRodriguez/molde@<version>) runscheckorverify:- it downloads the release it is pinned to (or
version:), with its SHA-256 checked; - it writes the report to the job summary and keeps one comment on the pull request up
to date, per workflow, job and site, escaping everything the report quotes; - it fails the job when the check fails (its verdict, or molde's exit code);
- every input is in
action.yml.
CI runs the action on the fixtures in every pull request.
- it downloads the release it is pinned to (or
Changed
links.internalcompares file names exactly, case included, on every file system. On
macOS (which ignores case by default) a link to/Logo.webpused to pass when the file is
logo.webp, and broke on the host (S3, Linux). A site with such a link now fails on every
machine: fix the spelling the report names. The build's files are listed once, instead of
asking the disk for each target.
Fixed
titles.duplicatecounts indexable pages only. A page carrying a robots noindex meta
(a not-found page written three times, as Next.js does, or a pager markedindex: false) is not a search result and may share a title. A site that failed only on such
pages passes. Nothing to do.- A robots noindex inside a comment, a script, a style or a
<template>is not the
page's:sitemap.noindex_listedfired on a listed page whose noindex was commented
out, andtitles.duplicatewould have skipped it. Crawlers index such a page. canonical.mismatch,og.mismatchandcanonical.not_in_sitemapcompare URLs as a
browser does: the scheme and host in any case, and an empty path the same as/
(https://Example.comandhttps://example.com:443arehttps://example.com/). A hand-written canonical that named
the right page in another spelling used to fail; it passes. The path is still compared
exactly.std_headalways wrote the normal form, so molde's own pages are unaffected.html.langaccepts a more specific tag of the page's locale:<html lang="en-US">on
anenpage used to fail, though it is valid and names the same language. A region
of another language (es-USon anenpage) still fails, and hreflang stays exact.
Nothing to do.molde serveanswers a miss with the nearest404.htmlup its path, so a prefixed
locale's/de/404.htmlshows under/de/; it used to show the root/404.html
everywhere. Nothing to do.molde serve --watchanswers from the start: it used to accept connections and answer
nothing until the startup check finished (minutes on a large site). The last good
build is served while that check runs, and with no build yet a "first build in
progress" page reloads itself until one publishes. Nothing to do.titles.multiplecounted an icon's<title>as a second page title when an SVG
sprite nests an<svg>inside a<symbol>(Sphinx's Furo theme does, on every page):
SVG and MathML are now skipped to their matching end tag. Nothing to do.- A reader that stops early (
molde check --site site | head) no longer makes molde
panic with "failed printing to stdout: Broken pipe"; the exit code is the command's
own. Nothing to do. links.internalreadhref=andsrc=in page text too, so a docs page showing HTML
in a code block (<link href="/favicon.ico">) failed on a link that
isn't one. Attributes are now read inside tags only, plus quoted URLs inside
<script>as before; a real link inside<code>still counts.href=text inside
another attribute's value, and framework bindings (:href,x-bind:href), are not
links either (gohugo.io's 788 and Starlight's 246 false errors). Nothing to do.
v0.1.0
The first public release. Since 0.1.0-rc.1:
Added
- New checks:
canonical.duplicateandog.duplicate(a second canonical link, or a
secondog:url,og:titleorog:type, usually a hand-written tag next to
{{ std_head }}), andog.title_mismatch(og:titleand<title>say different
things; one containing the other passes). A site that passed may now fail: remove the
extra tag, or make the og:title agree with the title. - The head checks read the markup only: a canonical or Open Graph tag inside a comment,
a script, a style or a<template>is no longer taken for the page's own. - New checks on
robots.txt, withbase_url:robots.sitemap_missing(noSitemap:
line naming<base_url>/sitemap.xml) androbots.blocks_all(User-agent: *with
Disallow: /on a site with pages to index). molde's own robots.txt passes both; astatic/robots.txt, which
replaces it, is now checked the same way. molde guideprints docs/agents.md, a short guide for agents and
people: the site layout,routes.yaml, templates, what the check covers and the
commands.molde --helppoints to it. Nothing to do: it is new.
Changed
-
The head checks (canonical, Open Graph, description) read attribute values in any
quoting, as browsers do:'…'and unquoted as well as"…", with attribute names in
any case. A correct head written with single quotes used to failcanonical.missing
andog.missing; it now passes. A single-quoted tag that contradictsstd_headused
to be invisible; it is now checked. -
links.internalchecks links written absolute to the site's own address. With
base_url: https://example.com,https://example.com/x/,http://example.com/x/and
//example.com/x/are links into the build, checked like/x/; before, they were
taken for another site and never checked. A site with such a link to a missing page
now fails: fix the link the report names. Other hosts are still not fetched.
agent-cost benchmark data, 19 Oct 2026
The run data behind docs/bench/agent-cost/REPORT.md: round 1 (the registered campaign, amendment 4 and the Sonnet row) and round 2A, 1,515 runs. Each run's metrics, verdict, metadata, diff and full agent transcript; the workspace snapshots are left out. README.txt inside says how to reproduce every table. Not a molde release.
v0.1.0-rc.1
The first public release candidate.
What molde does
molde checkrenders the site into an immutable build, runs every conformance
check, and returns one JSON report. It publishes (swapsout/current) only on a
passing verdict; otherwise the last good build stays live.- Commands:
build,check,routes,render,diff,gc,serve(with--watchand
--reload),events,mcp. - Site format:
routes.yaml(path patterns,foreach,paginate, title,
description, index and lastmod patterns, JSON-LD types), minijinja templates,
data.json, an optionalsite.yaml(web standards, size budgets, locales) and
translations/. - Pages can be left out of search engines with
index: false(noindex meta, kept out of
the sitemap). Withbase_url, molde writessitemap.xmland arobots.txtthat points
at it (your ownstatic/robots.txtwins). - Locales: the default locale at the root, or every locale prefixed
(prefix_default_locale);localized:fields per route;locales: nonefor pages that
belong to no language. - Template filters of molde's own:
slug,year,date_formatandnum_format, and
with localest,t_htmlandloc. - Builds: every page gets a precompressed
.gzsibling, an unchanged rebuild reuses the
previous build,molde diffcompares any two builds (--from,--to,--full),
molde gcprunes them, andmolde serveanswers missing pages with the site's
/404.html.molde eventstakes--portand--min-interval-secs. - Checks: internal links (relative ones,
srcsetand stylesheeturl()included),
text escaped twice, titles, the sitemap, canonical and Open Graph tags,
descriptions, robots, JSON-LD, output budgets, locales (paths,lang, hreflang,
translations), and a source layer that reports template and file errors with the
file, line, page and route. group_bymakes one page per distinct value of an item field (genre or tag pages),
following the data with no hand-kept list.{field|slug}in a path and theslug
filter in templates turn any value into a URL segment (Science Fiction→
science-fiction).- Errors name the fix: a
--sitefolder withoutroutes.yaml, aforeachor
paginate.overcollection missing fromdata.json(with the arrays that exist), a
{field}path value that is not a string or an integer, and a date filter given a
number. Integer fields ("id": 42) work in paths, and a UTF-8 byte order mark at the
start ofdata.jsonor a YAML file is ignored. .DS_StoreandThumbs.dbunderstatic/are not copied into builds, and a static
page's unquoted<meta name=robots content=noindex>counts as noindex like the
quoted forms.- Above 50,000 URLs or 50 MB,
sitemap.xmlbecomes a sitemap index of
sitemap-1.xml,sitemap-2.xml, …. molde mcpserves all of this to an agent over the Model Context Protocol.- Three example sites:
examples/demo(the quickstart),examples/multilingual(three
languages) andexamples/broken(five mistakes and the report that finds them). - Dates and numbers are formatted for 529 locales from bundled Unicode CLDR 48 data,
matching ICU byte for byte. - Release archives for Linux (x86-64, arm64; static) and macOS (arm64, x86-64), with
SHA-256 checksums and third-party licence notices. - molde runs on Linux and macOS and needs Rust 1.89 or newer to build from source.