Strapi Release: 1.4.1

TL;DR

Strapi v1.4.1 is a maintenance release that addresses several critical issues with GraphQL schema generation, application linking, and hook loading. This update ensures more reliable GraphQL middleware operation, improves the strapi link command functionality, and fixes hook loading for dashboard and router components. These fixes enhance stability for developers working with Strapi's GraphQL features and core functionality.

Highlight of the Release

• Fixed GraphQL middleware loading to properly wait for schema generation
• Improved strapi link command to properly clean up previous applications
• Fixed hook loading for dashboard and router components
• Updated waterline-graphql dependency

Migration Guide

No migration steps are required for this update. This is a patch release (v1.4.0 → v1.4.1) that fixes bugs without introducing breaking changes.

To update:

npm update strapi
# or
yarn upgrade strapi

After updating, restart your Strapi application to ensure all fixes are properly applied.

Upgrade Recommendations

This update is recommended for all Strapi v1.4.0 users, especially those:

• Using GraphQL functionality
• Working with the strapi link command
• Experiencing issues with dashboard or router hooks

The update contains important fixes that improve stability and prevent potential errors. As a patch release, it presents minimal risk of introducing new issues while resolving several known problems.

Bug Fixes

GraphQL Schema Generation

• Fixed an issue where the koa-graphql middleware was being loaded before GraphQL schemas were fully generated, which could cause startup errors or incomplete schema availability
• Updated the waterline-graphql dependency to improve compatibility and stability

Application Linking

• Fixed the strapi link command to properly delete previous application references before creating new ones, preventing conflicts and orphaned links

Hook Loading

• Fixed the loadHooks function specifically for the dashboard and router hooks which were not loading correctly
• Ensures proper initialization sequence for these critical system components

New Features

No new features were added in this maintenance release. This update focuses on bug fixes and stability improvements for existing functionality.

Security Updates

No specific security fixes were included in this release. The changes were focused on functional bug fixes and performance improvements rather than addressing security vulnerabilities.

Performance Improvements

GraphQL Middleware Loading

• Improved the loading sequence for GraphQL middleware by ensuring schemas are fully generated before the middleware is initialized
• This change provides more reliable startup performance and prevents race conditions that could cause intermittent failures

Application Management

• More efficient cleanup of previous applications when using the strapi link command, reducing potential resource conflicts

Impact Summary

This maintenance release addresses three specific issues that improve Strapi's stability and reliability:

1. GraphQL Middleware Loading: By ensuring GraphQL schemas are fully generated before loading the middleware, this fix prevents race conditions that could cause GraphQL endpoints to be unavailable or incomplete at startup.

2. Application Linking: The improved strapi link command now properly cleans up previous application references, preventing conflicts that could occur when linking multiple applications or relinking after changes.

3. Hook Loading: The fix for the loadHooks function ensures that dashboard and router hooks—both critical components of the Strapi system—initialize properly, preventing potential UI issues or routing problems.

While these changes are primarily under-the-hood fixes, they significantly improve the developer experience by eliminating frustrating edge cases and ensuring more predictable behavior of core Strapi functionality.

Full Release Notes