Repository navigation
Releases
v0.10.0
v0.10.0
Release date: 2026-10-17
Maintainer: exyonefs
Highlights
- Restructured the starter as a flat, minimal blog, reducing directory depth and default structural complexity for a lighter out-of-the-box experience.
- Modularized the theme into components and layers, and renamed design tokens by purpose to improve theme customization and long-term maintainability.
- Updated Feeds to accept the feed path and language as parameters, making it easier to support multilingual sites or multiple feed output paths.
Fixes and Improvements
- Fixed the extra blank line appearing below code blocks.
- Tightened starter typography and spacing for a better default reading experience.
Refactoring and Internal Changes
- Split theme styles into components and layers.
- Renamed design tokens to follow a purpose-based naming convention.
- Parameterized the Feeds module: feed path and language are no longer implicitly configured.
- Flattened the starter structure into a minimal blog layout.
- Established an initial commit containing only the current state as the version baseline.
Upgrade Notes
This release includes changes to theme token naming, Feeds invocation, and starter structure. Before upgrading customized projects, please check the following:
- Custom themes: Check for references to old design token names. If you have custom overrides, migrate them according to the new purpose-based naming rules. Since the theme is now split into components and layers, component/layer override paths may also need to be updated.
- Feeds usage: Check all Feeds call sites and confirm that the feed path and language are passed using the new parameterized approach. If you relied on the previous default behavior, verify the output paths and language results.
- Projects based on the old starter: If you modified the previous starter directly, re-check templates, configuration, and asset paths when migrating to the new flat structure.
- Back up your custom themes, starter configuration, and Feeds-related configuration before upgrading.
Full Changelog: https://github.com/exyonefs/zest/commits/v0.10.0
v0.9.0
v0.9.0 (2026-10-06)
- DSL convergence:
figure,details, andjoinWithnow live on the unified DSL layer. - Starter refresh: Updated default styles for
Zest.App.Starter. - Self-documenting templates: Renamed starter partials and taxonomy templates to clearly describe what they style.
Full Changelog: v0.8.0...v0.9.0
v0.8.0
v0.8.0 (2026-10-06)
Highlights
This release introduces a major naming and architectural refactor, a new markup DSL, improved templating, and enhanced build tooling.
Features & Improvements
Templating & Compatibility
- Renamed Nunjucks compatibility layer to Zealucks, then subsequently to Zestucks, while preserving full Nunjucks compatibility.
- Native Nunjucks includes are now correctly resolved from the
includesdirectory. - Updated project documentation (
README.md,Claude.md) to reflect the new naming and architecture.
Project Structure & Tooling
- Simplified and restructured the project directory layout for better clarity.
- Refactored project to clarify naming and responsibility boundaries across modules.
- Set up development tooling and project configuration for a smoother contributor experience.
- Added
_prebuild.fsxand_finalize.fsxhooks to extend and customize the build pipeline.
Markup DSL
- Unified DSL naming conventions across the codebase.
- Filled in missing Markup element builders and class shortcuts for a more complete and ergonomic API.
- Fixed self-closed non-void elements in the markup DSL to ensure standards-compliant output.
CLI & Build Experience
- Polished CLI help layout for improved readability.
- Hardened the build animator for more reliable feedback during builds.
Stats
- 12 commits
- 206 files changed
- 1 contributor
Contributors
- @exyone-js
Upgrade Notes
- If you were using the previous Nunjucks compatibility layer, update any references from
Nunjucks→Zealucks→Zestucks. - Review your template
includespaths to ensure they align with the newincludesdirectory resolution. - The new
_prebuild.fsxand_finalize.fsxhooks are optional but recommended for custom build steps.
Full Changelog: v0.7.3...v0.8.0
v0.7.3
v0.7.3 — Layout opt-out for self-contained pages
This release adds support for layout = "none", allowing pages to explicitly opt out of the layout chain.
- Layout bypass: The renderer now checks
meta.Layoutbefore falling back to the configured default. When set to"none"(case-insensitive), the page is rendered as raw output with no layout wrapper. - Self-contained outputs: Feeds, standalone scripts, and similar pages no longer inherit the site template, making them truly self-contained.
Full Changelog: v0.7.2...v0.7.3
v0.7.2
Separate categories from tags in the build pipeline.
Categories and tags were previously conflated into a single taxonomy
concept, which forced every page into one flat grouping and made it
impossible to model hierarchical categories alongside free-form tags.
Split the two into distinct domain types and generators so that
categories can drive navigation structure while tags remain
cross-cutting labels. Affected parsing, domain models, and the
taxonomy and pagination generators.
Full Changelog: v0.7.1...v0.7.2
v0.7.1
Zest SSG v0.7.1 — Release Notes
Released: September 12, 2026
Range: 0.7.0 → 0.7.1 (6 commits, 62 files changed, +1,088 / −2,973)
This is a focused follow-up to 0.7.0. The two themes are a substantially reworked incremental cache that now rebuilds only genuinely changed pages, and a drastic simplification of the bundled starter theme into a single-article LaTeX-style "paper" design. A number of i18n, metadata, routing, and theme modules were also tightened up.
Breaking Changes (Starter Template Only)
The zest init scaffold was reduced from a full blog to a single-article site. If you were relying on the old starter as a reference, note that the following were removed from the template:
_init.zest.fsx,_data/nav.toml, and theme_data/nav.toml- Locales (
_locales/en.toml,_locales/zh.toml) and the| ttranslation usage - Layouts
base.html,default.html,home.html,tag.html,tags.html,terms.html - Includes
footer.html,page-shell.html,themevars.html - Content pages
404,about,archives,features,index.zest.fsx,search,tags - All sample posts plus
content/posts/index.njk - The split ZCSS slices (
tokens,base,components,pages,responsive)
The site is now one Markdown article (content/index.md) rendered through a single post layout, with rss.zest.fsx, atom.zest.fsx, and sitemap.zest.fsx retained. Styles were consolidated into a single main.zcss.
The theme manifest was reset accordingly: oxygen is now version 1.0.0, author exyone, license BSD-2-Clause, description "The default theme for Zest SSG."
Note that this affects only newly generated sites. Existing projects are unaffected.
Incremental Build Correctness
This is the headline fix. The previous cache keyed staleness on file modification time and a global template signature, which in practice rebuilt more than necessary and could miss changes.
- Content-hash based staleness.
BuildCache.needsRebuildWithTextreplacesneedsRebuildWithDeps, comparing the source text hash rather than relying on mtime. Editing a file without advancing its timestamp is now detected. - Per-template diffing.
loadCachenow takes a list of(templatePath, templateText)pairs instead of a single signature. It diffs each template's content hash and marks only the pages that depend on a changed template as stale, so editing one layout rebuilds the affected pages rather than the whole site. - Per-page dependency tracking is broader. During the write phase, each page records a dependency on every level of its layout chain plus every include those layouts reference, resolved via the new
LayoutEngine.layoutChain,collectIncludePaths, andgetIncludePathMap. Previously only the top-level layout was recorded. - Cache writes are keyed by output path.
updateCacheWithHashnow takes theoutPathexplicitly, keeping the dependency and page caches consistent.
Layout and Include Loading
- Timestamp caching removed from
loadLayoutsandloadIncludes. Files are now read on every call. The rationale, documented in the code, is that an editor can rewrite a file without advancing its modification time; reading a handful of templates is negligible next to rendering the site. - Include-set content signature.
setIncludesMtimewas replaced bysetIncludesSignature, which invalidates the include-substituted layout cache when the content of any include changes — again, independent of timestamps. - Processed-layout cache key.
applyLayoutCachednow keys onpath | layoutHash | includesSignatureinstead ofpath | mtime. - Include path map merging.
BuildEnginenow merges the theme and project include path maps so a page can resolve which include files it depends on, with project entries winning.
Build Diagnostics
- Timing output trimmed. The per-phase
[Zest][timing]instrumentation added in 0.7.0 (includingfsi-cold-start,content-batchlayout,html-format,content-write,taxonomy-render, and the pagination/taxonomy sub-phases) was removed in favor of the simplified build-time prompt introduced in this release. ThemarkPhasecalls that remain use shorter labels (setup,content,assets).
Module Optimizations
The commit "Optimize i18n, metadata, routing, and theme modules" touched several subsystems:
I18n (LocaleLoader.fs)
- Inner locale dictionaries are now built directly as
IDictionaryvalues, removing the second widening pass and copy inloadLocales. formatTextappends literal runs in bulk instead of character by character.- A shared empty argument bag avoids allocating a dictionary for lookups without interpolation.
- JSON array values are read via
GetString()rather thanToString().Trim('"'). Directory.GetFilesreplaced withDirectory.EnumerateFiles.
Metadata (MetaParser.fs)
parseTomlWithLinesnow returnsoption, so a malformed+++block degrades to the extension-specific parser instead of being silently ignored — and reports the parse failure via a warning.- The F# comment header scan is index-based and stops at the first content line rather than walking the whole body.
- Compiled
tagSplitPatreplaces an inlineRegex.Splitcall. applyDefaultlowercases the key once so recognized keys andExtraentries share a single spelling.
Routing (PermalinkRouter.fs)
slugifyremoves invalid characters before collapsing hyphens, so punctuation between two words can no longer leave a doubled hyphen.computePermalinkanddefaultRoutenormalize the directory once and reuse it for both URL segments and file paths.
Theme (ThemeResolver.fs, ThemeConfigLoader.fs)
git clonenow drains stdout and stderr before waiting, avoiding a pipe-buffer deadlock on verbose clones; a timeout kills the process tree and cleans up the partial cache entry.- URL theme caching tests for any filesystem entry, not just files, so a theme whose root contains only directories is still a valid cache hit.
paththeme resolution wrapsGetFullPathin a try/with so a malformed path is reported instead of throwing.- Theme manifest parsing cleaned up with
tryGetStringandOption.orElse/Option.defaultValue, and pre-sized dictionaries. ThemeResolverdocumentation now states the invariant thatresolvenever throws for a bad source.
Documentation
README.mdsubstantially revised (large diff).src/Zest.App/Starters/README.mdrewritten to describe the single-article scaffold.src/Zest.App/Starters/_config.tomlreduced to site metadata, build options, a[theme]block, and a single[[taxonomies]]entry forseries(keeping the starter free of generated/tags/pages).Directory.Build.propsandzest.tomlbumped to0.7.1.
Internal Notes
BuildLayout.setIncludesMtimerenamed tosetIncludesSignature.LayoutEngine.currentIncludesMtimerenamed tocurrentIncludesSignature.LayoutEngine.getLastIncludesMtimereplaced bygetIncludePathMap/setIncludePathMap.- Starter
Zest.App.csprojembedded resource list updated to match the reduced file set;_init.zest.fsxis no longer embedded. atom.zest.fsx,rss.zest.fsx, andsitemap.zest.fsxnow filter articles byp.date <> ""instead of a/posts/URL prefix, matching the single-article layout.
Full Changelog: v0.7.0...v0.7.1
v0.7.0
Zest SSG v0.7.0 — Release Notes
Released: September 11, 2026
Range: 0.6.1 → 0.7.0 (11 commits, 78 files changed, +4,494 / −2,781)
This release is a major internal reorganization and a substantial build-performance push, alongside meaningful template-engine parity work. Highlights include batched F# layout evaluation, lock-safe atomic output writes, a template-aware incremental cache, an enable_html_minification switch, and full directory restructurings of the DSL, ZCSS, Nunjucks, and Handlebars subsystems.
Breaking Changes
- the project tagline is now "Zest: Easy Static-site Toolkit" (previously "Zealous Efficient Static Toolkit"). Package metadata, README, and
zest.tomlwere updated.
Performance
- Batched F# layout evaluation. Taxonomy and pagination generators previously entered FSI once per generated page (e.g. once per tag — ~25 round-trips per build). Layouts are now applied to all pages in a single batched FSI run per layout-chain level, cutting the dominant build cost. Failed tasks are retried individually so one bad page never loses its siblings.
- Two-phase content write. The content pipeline now partitions results into cached and rebuild pages first, applies layouts in one batched pass, then post-processes (format/minify) and writes in parallel. This removed the per-page FSI re-entry that dominated large builds.
- Parallel asset post-processing. CSS/JS formatting and minification now enumerate files once and process them with
Parallel.ForEach. - Template-aware incremental cache. A content hash over every layout and include (
computeTemplateSignature) invalidates the page cache when templates are edited, added, or deleted — while unchanged templates keep per-page reuse intact for fast incremental builds. - Includes mtime from single traversal. The second directory sweep for
includeswas eliminated;LayoutEngine.getLastIncludesMtime()now reuses the traversal already done byloadIncludes. - F# context caching.
Zest.Dsl.Context.ensurecaches the parsed context by(path, mtime), so repeated FSI evaluations within one build no longer re-read the JSON context file. Stale contexts are never served across builds. - Reference-equality context cache. The Nunjucks site-context cache now keys on
Object.ReferenceEqualsfor bothglobalDataandSiteConfiginstead of hash codes, eliminating accidental cache collisions. - Build phase timing. The build engine and content pipeline now emit
[Zest][timing]lines forsetup-init,fsi-cold-start,content-pipeline,taxonomy,pagination,assets-copy,asset-format, and sub-phases (content-batchlayout,html-format,html-minify,content-write,taxonomy-render,pagination-batchlayout, etc.), making long builds attributable to a specific stage. - Streaming FSI I/O. FSI stdout/stderr collection moved from
ConcurrentQueuetoBlockingCollection, giving the reader a proper blocking wait (TryTake(&line, 10)) instead ofThread.Sleep 10polling.
Build Reliability
- New
AtomicFilemodule. Output writes go to a unique sibling temp file and are thenFile.Move'd over the target with a bounded retry. This lets the preview/dev server's open read handles finish on the old file while new requests see the new one, and absorbs transient locks from antivirus scanners and editors. Used by the content pipeline, taxonomy generator, pagination generator, and asset post-processing. - Preview server reads with
FileShare.Delete.HttpServernow reads HTML and compressed assets throughReadAllTextWithDeleteShareAsync/ReadAllBytesWithDeleteShareAsync, so a concurrent atomic rename can swap the file under an in-flight response. - In-flight request tracking.
HttpServertracks fire-and-forget request tasks and waits up to 5 seconds for them onShutdown, instead of abandoning responses mid-write. - SSE/WebSocket broadcast no longer blocks the rebuild loop.
DevServer,PreviewService, andSocketHubnow snapshot the client list under the lock and write outside it, on a background task. - FSI child process is shut down on exit. One-shot builds (
BuildController) and both serve modes (DevServer,PreviewService) now callFsiSession.shutdown(), so the long-runningdotnet fsichild no longer holds the terminal open after Zest exits. Watch mode deliberately keeps it alive for reuse. - Non-blocking shutdown.
FsiSession.shutdown()usesMonitor.TryEnter(sync, 500)and falls back to killing the process tree directly, so shutdown never blocks on a 60 s evaluation timeout. - Failed page writes no longer abort the build. Individual write failures in the content pipeline are collected as errors and reported, rather than propagating.
New Features
enable_html_minification. A newSiteConfigflag (defaultfalse), wired throughConfigLoaderfrom_config.toml,[site], or[build]sections. HTML post-processing is split into its own phase with dedicated timing output; formatting takes priority when both flags are enabled.- HAML converter expanded:
#{expr}interpolation →{{ expr }}!!!/!!! 5/strict/frameset/transitional/1.1/basic/mobile/xml→ correctDOCTYPEdeclarations&= exprescaped output (alias of=)- Multi-line
{...}attribute hashes joined until braces balance - Attribute values now run through
renderInterp, soclass="#{cls}"works
- Liquid converter expanded:
forloop.parentloopcaptured into__parentloopbefore each nested loopbreak/continue→ Nunjucks equivalentsincrement/decrement→set-based arithmetic with output
- Pug converter expanded:
case/when/default→{% if %}/{% elif %}/{% else %}chains (when a, bbecomesa or bequality tests)while cond→ bounded{% for __while_i in range(0, 100000) %}with immediate{% break %}(documented 100k iteration cap)- Attribute parsing now handles optional commas and keeps nested
()/[]/{}values intact
ITemplateEnginedocumented. Filter, tag, and render contracts are now specified with XML docs, including the concurrency requirement thatRenderbe safe to call from parallel page workers.
Refactoring & Reorganization
The codebase was restructured into layered directories across four subsystems. All renames preserve public type names and namespaces, so external consumers are unaffected.
Zest.Dslreorganized intoCore/,Utility/,Css/,Sugar/,Html/,Data/,Metadata/,Migration/.Zest.Dsl.fsprojcompile order rewritten to reflect the new dependency layers.Zest.Engine/Zcssreorganized intoSyntax/,Evaluation/,Parsing/,Builtins/,Compilation/,Tooling/.NunjucksEngine.fs(1,610 lines) split into a dedicatedNunjucksEngine/directory:NunjucksTypes→NunjucksTokenizer→NunjucksCompiler→NunjucksEvaluator→NunjucksBlocks→NunjucksRenderer→NunjucksEntry.HbsEngine.fs(575 lines) split into a dedicatedHbsEngine/directory:HbsTypes→HbsTokenizer→HbsParser→HbsContext→HbsRenderer→HbsEntry.- Engine entry files renamed to drop the redundant
Enginesuffix. BuildCache.clearCachemoved earlier in the module so a signature mismatch during load can discard a stale cache immediately.- Project references cleaned up in
Zest.DslandZest.Engine.
Documentation
README.mdupdated for the_init.zest.fsxrename and the new tagline; the Acknowledgements section was removed.CLAUDE.mdsubstantially revised (large diff).Directory.Build.propsversion, assembly version, file version, description, and package tags updated to 0.7.0.zest.toml[meta]version and header updated.
Internal Notes
- New cache header shape:
# zest-cache v3 | engine=<sig> | tpl=<sig>. - New build dependency:
System.Threading/System.Threading.TasksinBuildEngine. ScriptRunnernow deletes the previous per-build context file onresetSession, preventing%TEMP%accumulation across builds.
Full Changelog: v0.6.1...v0.7.0
v0.6.1
Zest SSG v0.6.1 – August 8, 2026
A patch release with two important fixes for F# script evaluation.
- Fixed generic type inference – explicit type annotations are now injected for the
tagsfield, resolving a compile‑time ambiguity that could occur in some page scripts. - Improved page data injection – data is now embedded directly into the generated
.fsxscript instead of using a separate#loaddata file, reducing file I/O and improving reliability during builds.
No breaking changes. Upgrade to 0.6.1 via Directory.Build.props.
Full Changelog: v0.6.0...v0.6.1
v0.6.0
Zest SSG v0.6.0 – August 8, 2026
A special thank you to Mistral-Vibe, our newest AI collaborator, for contributing to this release – code reviews, refactoring suggestions, and pair‑programming sessions have been invaluable in raising code quality and consistency across the project. 🤝
This is a significant infrastructure release that improves maintainability, performance, and developer experience.
Added
- ZCSS caching layers – incremental compilation now caches parsed stylesheets; rebuilds of unchanged ZCSS files are almost instant.
- DSL helpers – new functions and shortcuts in the F# DSL to reduce boilerplate when building pages.
- Split Oxygen theme CSS – the theme’s styles are now organised into smaller, maintainable files (base, layout, components, utilities) instead of one monolithic
main.zcss.
Changed
- File renaming – all files and core types now follow the two‑word naming convention from
CLAUDE.md. This improves code clarity and consistency across the codebase. (Breaking change for direct references – see upgrade notes below.) - Locale system upgraded – multi‑language support is now more robust, with better fallback and language‑detection logic.
- Dev servers – improved reliability and faster hot‑reload feedback.
- Template engines – version alignment and internal cleanup across all renderers.
Upgrade Notes
This release introduces breaking changes due to file/type renames. If you are a contributor or maintainer working on the Zest source code, you will need to update your imports and references.
For end‑users using Zest as a tool, your site content and _config.toml remain unaffected – the changes are internal to the framework.
Update Directory.Build.props to 0.6.0 and enjoy the faster rebuilds and cleaner codebase.
Thanks again to Mistral for the collaboration – onward! 🚀
Full Changelog: v0.5.2...v0.6.0
v0.5.2
Zest SSG v0.5.2 – August 7, 2026
This release brings theme customisation, auto‑generated tag archives, performance improvements to FSI script evaluation, and listing pagination.
Added
- Theme parameters in
_config.toml– themes can now expose configurable options (e.g.[theme] accent_color = "#3c6a5a") to adjust styling without touching the theme files. - Auto‑generated tag archives – pages for each tag are automatically created at
/tags/<tag>/, listing all posts with that tag. No manual setup required. - Pagination for listings – posts list (
/posts/) now supports pagination via{% paginate %}blocks, withcurrentPage,totalPages, andprev/nextlinks.
Fixed
- FSI script evaluation – resolved a bug that caused inconsistent variable resolution in
_init.zest.fsx; full builds now run reliably. - Full‑build speed – FSI session reuse is now more aggressive, reducing cold‑start overhead across multiple build passes.
Changed
- Documentation – updated
CLAUDE.md(AI guidance) to reflect .NET 10+ target.
Upgrade Notes
If you use custom themes, you can now define theme parameters in _config.toml – see updated theme documentation.
Tag archives are built automatically; ensure your layout includes a /tags/ route if you wish to link them.
Full Changelog: v0.5.1...v0.5.2