4.0.0-next.7 (2025-10-19)

Bug Fixes

• exclude children when extracting react props (294bcfb)
• renderInertia route helper to match types signature of inertia.render (060c4df)
• vue props extraction helper (3c3e2a1)

Full Changelog: v4.0.0-next.6...v4.0.0-next.7

4.0.0-next.6 (2025-10-03)

Bug Fixes

• allow optional properties when ssr is disabled (de760dc)

Features

• allow using Layouts via resolvePageComponent method (d27d93f)

Full Changelog: v4.0.0-next.5...v4.0.0-next.6

4.0.0-next.5 (2025-10-03)

Features

• remove config.entrypoint as the property is never used (0fd9b90)
• remove shared props from props required during rendering a page (c1ee7b9)

Full Changelog: v4.0.0-next.4...v4.0.0-next.5

4.0.0-next.4 (2025-09-30)

Bug Fixes

• pass containerResolver to the serialize method (1890a20)

Full Changelog: v4.0.0-next.3...v4.0.0-next.4

4.0.0-next.3 (2025-09-27)

Bug Fixes

• import the augmented module (66e7bb3)
• read manifest by invoking the method (d08d7f5)

Features

• allow eager loaded pages objects (709cc63)
• lazily evaluate page props types (2ee31ef)

Full Changelog: v4.0.0-next.2...v4.0.0-next.3

4.0.0-next.2 (2025-09-23)

Bug Fixes

• remove latest tag from release-it config (42d0359)

Features

• add helper to resolve pages (7e08132)

Full Changelog: v4.0.0-next.1...v4.0.0-next.2

This release introduces a major revamp of how type-safety is handled in Inertia applications. After upgrading, you may run into some TypeScript errors. They’re usually simple to fix, but can feel repetitive (a good use case for an AI agent).

See also: RFC - End-to-End type safety

Type-safety improvements

Previously, the inertia.render method was not type-safe. You could pass any values, even if they didn’t match what the client-side component expected.

With this release, the inertia.render method is now strictly typed. The framework automatically scans your Inertia pages and extracts their prop types.

You can pass component props directly or compute them using Transformers. In addition, helpers like inertia.lazy, inertia.defer, and inertia.merge are now type-safe. For example, you can no longer use inertia.defer for a required prop.

Shared data changes

The sharedData property has been removed from the config file and moved into middleware.

Why? Because computing shared data often requires pulling in transformers, models, or services from across your app. Importing all of that inside a config file goes against framework principles.

From now on, new Inertia apps will include an InertiaMiddleware in the app/middleware directory. You should use this middleware to define shared data.

Upgrading existing apps

This is an alpha release. We don’t recommend upgrading existing applications yet. Please wait for the stable release, which will include a detailed upgrade guide.

Changes

• Export InertiaFactory for unit testing
• Remove stubs and configuration command (moved to starter kits)
• Rename the client export to vite
• Make the route.renderInertia method type-safe
• Add support for deep-merging props
• Remove shared data from the config file → use InertiaMiddleware instead
• Make the inertia.render method type-safe
• Make the inertia.location method synchronous
• Use Symbols to identify branded types created with inertia.always, inertia.defer, inertia.optional, etc.
• Reflash session data when performing a full reload due to a version mismatch
• Add inertia.page to create a page object
• Add inertia.ssrEnabled to check if SSR is enabled for a page
• Add inertia.getVersion to get the assets version
• Add inertia.requestInfo to access request details (cached after first call, with an option to re-compute)
• Replace config.history.encrypt with config.encryptHistory

Features

• add support for generating pages (31ddf21)
• revamp implementation (0fa9dc6)

BREAKING CHANGES

• This commit contains serveral breaking changes around the Inertia setup.
  Same will be covered in the release notes

Full Changelog: v4.0.0-next.0...v4.0.0-next.1

4.0.0-next.0 (2025-07-21)

• Migrated to new @adonisjs/vite version
• Migrated to new build process. We are now using Vite Environment API.

Full Changelog: v3.1.1...v4.0.0-next.0

3.1.1 (2025-03-07)

Bug Fixes

• support "callback" props with InferPageProps (e98fc5d), closes #65

3.1.0 (2025-01-29)

Bug Fixes

• error on render when session is undefined (#59) (1326df2)

Features

• add @japa/api-client 3.x support to peerDependencies (#56) (6ebeca2)

What's Changed

• Adding dumper stack to root edge pages by @tomgobich in #54
• add @japa/api-client 3.x to peerDependencies by @marcuspoehls in #56
• fix: error on render when session is undefined by @limwa in #59

New Contributors

• @tomgobich made their first contribution in #54
• @limwa made their first contribution in #59

Full Changelog: v3.0.1...v3.1.0