●Change8

Migrating to Next.js v16.2.1-canary.12

Version v16.2.1-canary.12 introduces 1 breaking change. This guide details how to update your code.

Released: 3/28/2026

1
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

SingleModuleReference::assetSingleModuleReference::modulenapi(object) structs

Breaking Changes

●Issue #1

Renamed SingleModuleReference::asset to SingleModuleReference::module. Code using ::asset must be updated to use ::module.

Migration Steps

  1. 1
    Rename usages of SingleModuleReference::asset to SingleModuleReference::module.

Release Summary

This release introduces new offline state management features via the useOffline flag and hook, and includes internal refactoring such as renaming a field in SingleModuleReference and optimizing string usage in napi structs.

Need More Details?

View the full release notes and all changes for Next.js v16.2.1-canary.12.

View Full Changelog