Ghost Release: 4.9.1

TL;DR

Ghost 4.9.1 is a maintenance release that fixes critical bugs affecting custom themes and newsletter display in Gmail on Android. It includes significant internal code refactoring to improve maintainability, particularly in the theme service and API structure. This release focuses on bug fixes and technical debt reduction rather than introducing new features.

Highlight of the Release

• Fixed issue with custom themes not working properly by upgrading Gscan to 4.1.1
• Fixed newsletter display issue in Gmail on Android where images caused small text
• Improved cache invalidation on several routes for better performance
• Extensive internal code refactoring to improve maintainability

Migration Guide

No migration steps are required for this release. This is a maintenance release focused on bug fixes and internal improvements that should not affect existing installations.

Upgrade Recommendations

This release is recommended for all users, especially for:

• Users who rely on custom themes, as it fixes an issue that prevented custom themes from working properly
• Newsletter publishers who have readers using Gmail on Android, as it fixes a display issue with small text around images

The upgrade process should be straightforward with no breaking changes or migration steps required.

Bug Fixes

• Fixed custom themes not working properly by upgrading Gscan to 4.1.1
• Fixed small text in Gmail on Android for newsletters containing images by adding explicit width: auto to images, ensuring proper responsive behavior
• Fixed error when requesting resize of a blank image by adding a guard for empty buffers when reading files from storage for resizing, redirecting to the original file instead
• Improved cache invalidation on several routes:
  • Added invalidation to PUT /authentication/setup
  • Added invalidation to POST /db
  • Added invalidation to DELETE /db
  • Added invalidation to GET /slugs/:type/:name
  • Removed invalidation from PUT /users/:id/token

New Features

• Added savedIndicator alpha labs flag for use in the Admin client while working on editor saved/unsaved status indicator

Security Updates

No specific security fixes were included in this release.

Performance Improvements

• Improved cache invalidation on several routes to ensure better performance and data consistency
• Refactored theme service to use async/await instead of promise chains, making the code more readable and maintainable
• Unified ThemeValidationError generation code to reduce code duplication and improve error handling
• Reorganized test execution order to optimize development workflow, running linting after unit tests

Impact Summary

Ghost 4.9.1 is primarily a maintenance release that addresses two important bugs affecting theme functionality and newsletter display. The fix for custom themes not working properly is particularly important for sites using custom themes, while the fix for small text in Gmail on Android newsletters will improve the reading experience for subscribers using that platform.

Beyond the visible bug fixes, this release includes substantial internal code refactoring aimed at improving maintainability and setting the groundwork for future improvements. The theme service has been significantly refactored to use modern async/await patterns, and the API structure has been reorganized for better clarity and maintainability.

While these internal changes aren't immediately visible to users, they represent important technical debt reduction that will enable more robust feature development in the future. The improved cache invalidation on several routes should also provide better performance and data consistency.

Full Release Notes