Ghost Release: 5.82.1

TL;DR

Ghost v5.82.1 introduces an improved post-setup onboarding flow with a new checklist on the dashboard, fixes a critical settings crash caused by a type error, and includes mobile UI improvements. This release enhances the user experience for new Ghost installations while addressing stability issues.

Highlight of the Release

• New onboarding checklist on the dashboard replacing the setup/done screen
• Fixed critical settings crash caused by a type error
• Improved mobile UI for onboarding screens
• Updated to tiptap v2.2.6

Migration Guide

No migration steps are required for this release. The update primarily focuses on UI improvements and bug fixes that don't require any action from users.

Upgrade Recommendations

This release is recommended for all Ghost users, especially those experiencing crashes in the Settings page. The update provides important stability improvements and enhances the onboarding experience for new installations. As this is a patch release (v5.82.1), it should be safe to upgrade without concerns about breaking changes.

Bug Fixes

Critical Fixes

• Fixed a Gscan type error that was causing the Settings page to crash
  • Added additional safety checks to ensure required data exists before rendering elements
  • Prevents the API from crashing when data isn't formatted correctly
  • Resolves an issue that was being reported to Sentry (ref: ENG-189)

Mobile UI Fixes

• Fixed positioning of the "skip onboarding" button on smaller screens (fixes IPC-141)
• General mobile improvements to the onboarding flow (fixes IPC-142)

Test Stability

• Fixed browser tests that were broken by the onboarding changes
• Updated tests to accommodate the removal of the setup/done screen
• Fixed an issue where the setup flow was showing an alert bar due to not handling the TransitionAborted error thrown during redirect

New Features

Improved Onboarding Experience

• Replaced the setup/done screen with a new onboarding checklist shown directly on the dashboard
• The checklist provides guided steps for new users to complete their Ghost setup
• Better mobile experience with improved layout and button positioning
• Updated tiptap editor components to version 2.2.6

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were mentioned in this release.

Impact Summary

Ghost v5.82.1 focuses on improving the onboarding experience and fixing critical bugs. The new onboarding checklist on the dashboard provides a more intuitive setup process for new users, while the fix for the Settings page crash addresses a stability issue that was affecting site configuration. Mobile improvements ensure a better experience on smaller screens. This release represents an important quality-of-life update that enhances usability without introducing breaking changes.

Full Release Notes