CHANGELOG.md

Release Notes

Unreleased

• Nothing!

v2.0.22 - 2026-03-11

What's Changed

• [2.x] Prevent Boost conflict by @pascalbaljet in #838
• [2.x] Fix SSR shutdown URL construction by @pascalbaljet in #843

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.21...v2.0.22

v2.0.21 - 2026-02-24

What's Changed

• [2.x] Supports Laravel 13 by @crynobone in #822
• Add Boost Guidelines & Skills by @pushpak1300 in #828

New Contributors

• @pushpak1300 made their first contribution in #828

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.20...v2.0.21

v2.0.20 - 2026-02-13

What's Changed

• Removed duplicate import of RedirectResponse by @kitro in #813
• [2.x] Add assertInertiaFlash and assertInertiaFlashMissing test response macros by @pascalbaljet in #827
• Fix inertia prop modifiers being ignored in provider classes by @TimKunze96 in #821

New Contributors

• @kitro made their first contribution in #813
• @TimKunze96 made their first contribution in #821

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.19...v2.0.20

v2.0.19 - 2026-01-13

What's Changed

• [2.x] Allow ScrollProp to be deferred by @pascalbaljet in #806

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.18...v2.0.19

v2.0.18 - 2025-12-31

What's Changed

• Add test helpers for Flash Data by @pascalbaljet in #804

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.17...v2.0.18

v2.0.17 - 2025-12-30

What's Changed

• Fix flash data loss on non-Inertia redirects by @TomKita in #802

New Contributors

• @TomKita made their first contribution in #802

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.16...v2.0.17

v2.0.16 - 2025-12-17

What's Changed

• Add test for deferred metadata on subsequent request by @pascalbaljet in #799
• Support for Flash Data by @pascalbaljet in #797

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.15...v2.0.16

v2.0.15 - 2025-12-15

What's Changed

• Check if prop value is callable and not a string by @pascalbaljet in #798

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.14...v2.0.15

v2.0.14 - 2025-12-10

What's Changed

• Exclude loaded once props from deferred metadata by @pascalbaljet in #796

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.13...v2.0.14

v2.0.13 - 2025-12-10

What's Changed

• Include onceProps metadata for fresh props by @skryukov in #794

New Contributors

• @skryukov made their first contribution in #794

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.12...v2.0.13

v2.0.12 - 2025-12-09

What's Changed

• Ability to use <script> element for initial page data by @pascalbaljet in #788
• Support for once() props by @pascalbaljet in #793

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.11...v2.0.12

v2.0.11 - 2025-11-26

What's Changed

• Add PHP 8.5 to test matrix by @pascalbaljet in #787
• Support for multiple validation errors per field by @pascalbaljet in #784
• Handle array inputs in reloadOnly and reloadExcept by @hosmelq in #792
• Handle Connection Exceptions During Health Checks by @Magnesium38 in #786

New Contributors

• @Magnesium38 made their first contribution in #786

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.10...v2.0.11

v2.0.10 - 2025-09-28

What's Changed

• Include scrollProps metadata when prop is requested to reset by @pascalbaljet in #781

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.9...v2.0.10

v2.0.9 - 2025-09-26

What's Changed

• Add docblock to Inertia Facade for scroll by @joetannenbaum in #780

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.8...v2.0.9

v2.0.8 - 2025-09-26

What's Changed

• More fine-grained control for Inertia::merge() and a new Inertia::scroll() by @pascalbaljet in #774

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.7...v2.0.8

v2.0.7 - 2025-09-24

What's Changed

• Added loadDeferredProps() method to AssertableInertia class by @pascalbaljet in #779

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.6...v2.0.7

v2.0.6 - 2025-08-26

What's Changed

• Add encrypt history middleware that follows laravel naming conventions by @taylorotwell in #773

New Contributors

• @taylorotwell made their first contribution in #773

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.5...v2.0.6

v2.0.5 - 2025-08-12

What's Changed

• [2.x] Improve inertia helper docblock by @mtlukaszczyk in #766
• [2.x] Introduce ProvidesInertiaProp interface by @pascalbaljet in #746
• [2.x] Introduce ProvidesInertiaProps interface by @pascalbaljet in #769
• Introduce PHPStan + improve DocBlocks by @pascalbaljet in #768

New Contributors

• @mtlukaszczyk made their first contribution in #766

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.4...v2.0.5

v2.0.4 - 2025-07-15

What's Changed

• [2.x] Ability to perform a SSR request without a bundle by @pascalbaljet in #751
• [2.x] Added inertia:check-ssr Artisan command and isHealthy() method on HttpGateway by @pascalbaljet in #752
• [2.x] Refactor HttpGateway by @pascalbaljet in #754
• [2.x] Support for checking if the component exists when rendering by @pascalbaljet in #749
• [2.x] Refactored ssr.dispatch_without_bundle to ssr.ensure_bundle_exists by @pascalbaljet in #755
• [2.x] Restore testing.page_paths and testing.page_extensions configs by @pascalbaljet in #756
• GitHub issue template by @pascalbaljet in #757
• update return type in Middleware share method by @hosmelq in #758
• Fix project name in SECURITY.md by @duncanmcclean in #759
• [2.x] Remove old version checks by @pascalbaljet in #763

New Contributors

• @hosmelq made their first contribution in #758
• @duncanmcclean made their first contribution in #759

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...v2.0.4

v2.0.3 - 2025-06-20

What's Changed

• Run tests on Ubuntu 24.04 by @pascalbaljet in #735
• Improve URL handling with support for trailing slashes by @ljbw in #731
• [2.x] Remove old LegacyTestResponse by @nshiro in #736
• [2.x] Introduce inertiaProps Method in TestResponseMacros for Improved Inertia.js Testing by @ashokatheheroo in #700
• [2.x] Remove check for TestResponse from Laravel <= 6.0 by @pascalbaljet in #743
• [2.x] Check Vite manifest before Mix manifest by @pascalbaljet in #737
• [2.x] Remove IDE helpers by @ycs77 in #675
• [2.x] Allow deepMerge on custom properties by @mpociot in #732
• [2.x] Test helper for partial requests by @pascalbaljet in #738
• [2.x] Support for a custom URL resolver by @pascalbaljet in #739
• [2.x] Keep only partial data in mergeProps by @vinnygambiny in #745
• [2.x] Refactor mergeStrategies argument to matchOn() method by @pascalbaljet in #747

New Contributors

• @ljbw made their first contribution in #731
• @nshiro made their first contribution in #736
• @ashokatheheroo made their first contribution in #700
• @mpociot made their first contribution in #732
• @vinnygambiny made their first contribution in #745

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.2...v2.0.3

v2.0.2 - 2025-04-10

What's Changed

• [2.x] Supports Laravel 12 by @crynobone in #709
• Add Inertia::deepMerge Method for Handling Complex Data Merges in Responses by @HichemTab-tech in #679
• Improve PHPDoc annotations for ResponseFactory class by @mohammadrasoulasghari in #723
• fix props that extends Responsable after closures / lazy props by @d8vjork in #722
• [2.x] Allow environment config for ssr.enabled, ssr.url, and history.encrypt by @bram-pkg in #714
• Replace array_merge with spread operator in middleware.stub by @osbre in #710
• [2.x] Resolve Closure before checking if a prop implements the Arrayable contract by @rodrigopedra in #706
• Handle SSR URLs with trailing slashes by @simon-tma in #705
• [2.x] Call toArray() on Arrayable props resolved from the Container by @pascalbaljet in #696
• [2.x] Replace md5 with xxhash by @RobertBoes in #653

New Contributors

• @HichemTab-tech made their first contribution in #679
• @mohammadrasoulasghari made their first contribution in #723
• @d8vjork made their first contribution in #722
• @bram-pkg made their first contribution in #714
• @osbre made their first contribution in #710
• @simon-tma made their first contribution in #705
• @pascalbaljet made their first contribution in #696

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.1...v2.0.2

v2.0.1 - 2025-02-18

• Allow Laravel 12.x.

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.0...v2.0.1

v2.0.0

• Add support for Inertia.js v2.0.0
• Add Inertia::defer() to support deferred props
• Add Inertia::merge() to support merging props on client
• Add Inertia::always() for props that should always be included (#627)
• Add Inertia::clearHistory() and Inertia::encryptHistory() methods, encryption config, and encryption middleware
• Deprecated Inertia::lazy() in favor of Inertia::optional()
• Drop support for Laravel 8 and 9 (#629)

v1.2.0 - 2024-05-17

• Make commands lazy (#601)
• Add persistent properties (#621)
• Exclude except props from partial reloads (#622)

v1.1.0 - 2024-05-16

• Support dot notation in partial requests (#620)
• Add $request->inertia() IDE helper (#625)

v1.0.0 - 2024-03-08

• Add Laravel 11 support (#560, #564)
• Fix URL generation (#592)
• Remove deprecated Assert class and Laravel 6 & 7 support. (#594)

v0.6.11 - 2023-09-13

• Add option for using the bun runtime in SSR (#552)

v0.6.10 - 2023-09-13

• Add inertia_location helper function (#491)
• Add Route::inertia() IDE helper (#413)
• Automatically update Facade docblocks (#538)
• Restore request and session on redirects (#539)
• Add PHP 8.3 support (#540)

v0.6.9 - 2023-01-17

• Conditionally use pcntl extension in inertia:start-ssr command (#492)

v0.6.8 - 2023-01-14

• Reintroduce inertia.ssr.enabled config option (#488)
• Fix bug where SSR is dispatched twice when errors exist (#489)

v0.6.7 - 2023-01-12

• Report SSR errors (#486)
• Auto enable SSR based on existence of SSR bundle (#487)

v0.6.6 - 2023-01-11

• Add inertia:start-ssr and inertia:stop-ssr artisan commands (#483)

v0.6.5 - 2023-01-10

• Add Laravel v10 support (#480)

v0.6.4 - 2022-11-08

• Add PHP 8.2 support (#463)

v0.6.3 - 2022-06-27

• Check Vite manifest path (build/manifest.json) when determining the current asset version (#399)

v0.6.2 - 2022-05-24

• Switch to using the Vary: X-Inertia header (#404)
• Fix bug with incompatible $request->header() method (#404)

v0.6.1 - 2022-05-24

• Set Vary: Accept header for all responses (#398)
• Only register Blade directives when actually needed (#395)

v0.6.0 - 2022-05-10

Added

• Inertia now redirects back by default when no response is returned from a controller (#350)
• The Middleware has an overridable onEmptyResponse hook to customize the default 'redirect back' behavior (#350)

Changed

• Internal: Replaced the Middleware's checkVersion method with an onVersionChange hook (#350)

Fixed

• Fixed namespace issue with Route::inertia() method (#368)
• Added session check when sharing validation errors (#380)
• Fixed docblock on facade render method (#387)

v0.5.4 - 2022-01-18

Added

• .tsx extension is now included to the testing paths by default (#354)

Fixed

• Dot-notated props weren't being removed after unpacking (507b0a)

v0.5.3 - 2022-01-17

Fixed

• Incorrect Arrayable type-hint (#353)
• Pagination with API Resources and other nested props weren't resolving properly (#342, #298)

v0.5.2 - 2022-01-12

Added

• Laravel 9 Support (#347)

Fixed

• Respect X-Forwarded-For header (#333)

v0.5.1 - 2022-01-07

Fixed

• When the SSR Server crashes, a null response will be returned, which wasn't being handled properly (7d7d89)

v0.5.0 - 2022-01-07

Added

• PHP 8.1 Support (#327)
• Allow Inertia::location to be called with a RedirectResponse (#302)
• Support Guzzle Promises (#316)
• Server-side rendering support (@inertiaHead directive) (#339)
• Allow custom @inertia root element ID (e.g. @inertia('foo') -> <div id="foo" data-page="...) (#339)

Changed

• We now keep a changelog here on GitHub 🎉 For earlier releases, please see the releases page of inertiajs.com.
• Add PHP native type declarations (#301, #337)

Deprecated

• Deprecate Assert library in favor of Laravel's AssertableJson (#338)

Removed

• Laravel 5.4 Support (#327)

Fixed

• Transform Responsable props to arrays instead of objects (#265)
• Inertia::location(): Fall back to regular redirects when a direct (non-Inertia) visit was made (#312)
• Use correct types for Resources (#214)