Release Notes

3.6.0

8 September 2026

New Features

Tests

  • Reduce boilerplate and repetition in the test code

3.5.6

5 September 2026

Documentation Changes

  • Extend the Deploying documentation with a Docker section

3.5.5

24 August 2026

Bugfixes

  • Fix atom feeds being generated with the wrong <link rel="self"> href value

3.5.4

22 August 2026

Bugfixes

  • Saga now refreshes the files on disk after beforeRead and after each processing step, so that files written during those steps are available in subsequent steps

3.5.3

15 August 2026

Documentation Changes

  • Add a guide on opening external links in new tabs

3.5.2

14 August 2026

New Features

  • The sorting parameter of register(fetch:) is now optional, keeping the order you returned the items in

3.5.1

13 August 2026

Documentation Changes

  • Add a deployment section to the docs

3.5.0

6 July 2026

New Features

  • Add itemTitle parameter to atomFeed for per-entry title policy (#53 by deverman)

3.4.2

26 June 2026

Bugfixes

  • Prevent crashing with multiple changes in succession to same file (#52 by deverman)

3.4.1

13 May 2026

Documentation Changes

  • Improve Getting Started documentation

3.4.0

1 May 2026

New Features

  • Simplified the API by deprecating register {}, which is functionally replaced by afterWrite {}

3.3.2

9 April 2026

Documentation Changes

  • Improve docs and guides

3.3.1

4 April 2026

Bugfixes

  • Fix nested pipelines on incremental rebuilds

Documentation Changes

  • Improved example app: the photos are now shown with EXIF data thanks to SagaImageReader 1.2.0

3.3.0

4 April 2026

New Features

  • Renamed ignore to ignoreChanges, to remove ambiguity

3.2.0

2 April 2026

New Features

  • Add a buildReason property to Saga
    This allows you to only do certain work when certain files have changed. For example, only run SwiftTailwind when css or template files were changed.

Documentation Changes

  • Link to GetSaga.dev for a complete overview of all available plugins
    It’s too difficult to maintain this list in multiple places.

3.1.0

31 March 2026

New Features

  • Add a new DictRenderingContext protocol, for use with renderers that expect to use a dictionary instead of a struct

Documentation Changes

  • Improve docstrings by linking to guides
  • Add Syntax Highlighting guide

3.0.0

26 March 2026

New Features

  • Support for incremental builds! Instead of saga dev always starting a brand new build on every file change, Saga is now kept alive and just reruns the pipeline, while caching the entire read step. This relies on saga-cli version 2.
  • Remove deprecated code
  • Support for localization (i18n) (#50 by kevinrenskers)

Documentation Changes

  • Add a new “Custom Feed Formats” guide
  • Add a feature comparison to the readme

BREAKING CHANGES

  • CLI flags --input, --output and --ignore removed
  • Pre/post pipeline code must move to beforeRead and afterWrite hooks

Please check the migration guide for more information.