Skip to main content

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.2.9] - 2026-02-22​

Changed​

  • Moved auto-generated files to public/generated/ subdirectory for cleaner structure.

[1.2.8] - 2026-02-20​

Fixed​

  • Duplicate meta tags in <head> caused by hardcoded tags in index.html conflicting with dynamically added tags from Layout.jsx and react-helmet in Header.jsx.

[1.2.7] - 2026-02-17​

Added​

  • Development workflow with :development Docker tag for testing changes without affecting :latest users.
  • Automatic robots.txt generation during build process with sitemap URL from config.yaml. (#12)
  • Support for description field in piece frontmatter for RSS feed descriptions (with fallback to first line of content). (#11)
  • Routing support for /feed/, /sitemap/, /robots, and /robots.txt in both nginx and Vercel configurations. (#12)
  • Version badge (v1.2.7) in documentation site navbar.

Changed​

  • RSS feed <link rel="self"> now correctly points to /feed.xml instead of /feed. (#11)
  • Footer styling restructured for better alignment on large displays - border now on article element with footer integrated into HomepageViewer component. (#13)
  • Vercel rewrite rules optimized with specific routes ordered before catch-all pattern.

Fixed​

  • RSS feed validation errors: removed invalid managingEditor field (was not in email format). (#11)
  • RSS feed item structure: <description> now appears before <content:encoded> per RSS 2.0 best practices. (#11)
  • Footer border extending beyond content on larger displays due to float-based alignment. (#13)

Removed​

  • managingEditor field from RSS feed generation (optional field causing validation warnings). (#11)

[1.2.5] - 2025-12-27​

Added​

  • New landing page at ode.dimwit.me with links to live demo, documentation, and repository.
  • Official documentation site powered by Docusaurus, featuring automated root markdown synchronization and search for easy access.

Changed​

  • Image galleries in the README.md and THEMING.md have a slightly different layout now to make them better appear in the documentation.

[1.2.2] - 2025-12-01​

Fixed​

  • Responsive horizontal margins now scale smoothly across existing intermediate breakpoints (xl, lg) to prevent excessively large margins on tablets and narrow desktop windows. (#3)

[1.2.1] - 2025-12-01​

Changed​

  • Updated README.md's intro text to better answer "what is it?" first.

[1.2.0] - 2025-12-01​

Added​

  • Dynamic theme engine with 10 built-in presets (almanac, blueprint, comic, doodle, exploit, journal (default), manuscript, recipe, screenplay, sketch).
  • Theme configuration via ui.theme.preset, ui.theme.overrides, and ui.theme.defaultMode in config.yaml (fully backwards compatible; not having the sections does not break anything).
  • Support for local font files with automatic format detection.
  • Font scaling system with proportional sizing using --font-scale CSS variable.
  • Comprehensive theming documentation in THEMING.md with screenshots of all presets.
  • Theme presets automatically register from src/assets/themes/ directory.
  • New ETHOS.md documenting core principles and philosophy.

[1.1.2] - 2025-11-26​

Added​

  • Defaults are now initialised if the public directory is empty or has any files missing from the required structure. Helpful links will directly appear on the UI and the app will not break.
  • A build badge is added to the README to ensure Docker image status is always easy to find.
  • New pages.notFound config option to specify a custom 404 page (defaults to obscured).
  • Exclusions in exclude.pages and exclude.pieces now accept slugs without .md extension.

[1.1.1] - 2025-11-26​

Added​

  • New config.yaml parameter to control Body of Work order. If your config does not have the parameter and you update the app, it will default to descending.

[1.1.0] - 2025-11-26​

Added​

  • Major (breaking) change since the app now moves to a docker-compose.yaml setup fundamentally changing how to write content in it. README.md will have more context but you can now mount directories for content (pieces and pages) while using the public image to constantly rebuild the site on push or update. You are free to set this up yourself. config.yaml, intro.md, and favicon.ico can also be mounted.
  • Documentation for setting up a content repository and automation is now also available in WRITING.md.

[1.0.3] - 2025-11-26​

Added​

  • Feature: New config.yaml parameter will let you configure number of RSS feed items

[1.0.2] - 2025-11-25​

Added​

  • Feature: Gestures! The Reader mode now supports trackpad swipe and mobile swipe gestures.

[1.0.1] - 2025-11-24​

Added​

  • Feature: Added sitemap generation script at the build process.

Changed​

  • Fix: Fixed an issue where URLs with / in the end would not strip to valid URLs.

[1.0.0] - 2025-11-23​

Added​

  • Initial public release of Ode.
  • Markdown-based content system for pieces and pages.
  • Reader mode with keyboard navigation.
  • Dark/Light mode with automatic theme switching.
  • RSS feed generation for all pieces.
  • Chronological "Body of Work" archive.
  • Random piece discovery feature.
  • Fully configurable site metadata and UI labels via config.yaml.
  • Build-time generation for optimal performance.
  • MIT License.