nextjs-16

Enforce Next.js 16 migration patterns for async params, proxy.ts, and Turbopack.

27|11|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/mjunaidca/mjs-agent-skills --skill nextjs-16
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nextjs-16
Source: https://github.com/mjunaidca/mjs-agent-skills/tree/main/.docs/taskflow-vault/skills/engineering/nextjs-16
Command: npx skills add https://github.com/mjunaidca/mjs-agent-skills --skill nextjs-16

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Highlights Next.js 16 breaking changes and patterns to prevent common migration mistakes.

Core Features & Use Cases

  • Async params, proxy.ts (instead of middleware)
  • Turbopack defaults and cacheComponents
  • Parallel routes and routing patterns

Quick Start

Review the breaking changes section and update params, proxy usage, and turbopack config accordingly.

Frequently Asked Questions about nextjs-16

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the breaking changes I need to handle when migrating to Next.js 16?

Next.js 16 introduces breaking changes including async params in route segments, migration from middleware to proxy.ts, Turbopack as the default bundler, the cacheComponents flag, and updated Image component usage. Review these patterns before upgrading to prevent common mistakes.

How do I migrate middleware to proxy.ts in Next.js 16?

Replace middleware.ts with proxy.ts to handle request interception in Next.js 16. Proxy.ts uses a different pattern for routing and request modification. Update your middleware logic to match the new proxy-based approach before deploying.

Do I need to update my route params to async in Next.js 16?

Yes, Next.js 16 requires async params and searchParams in route segment configurations. Update your params function to be async and handle dynamic routes correctly to align with the new routing patterns.

What's the difference between dynamicIO and cacheComponents in Next.js 16?

Next.js 16 transitions from dynamicIO to the cacheComponents flag for controlling component caching behavior. Enable cacheComponents in your configuration and update async context usage in route handlers accordingly.

How do parallel routes work with Next.js 16's new patterns?

Parallel routes in Next.js 16 require default.js files for each slot and proper async param handling. Structure your routes to leverage parallel rendering while following the updated segment configuration patterns.

Why is Turbopack now the default in Next.js 16?

Turbopack is the default bundler in Next.js 16 for improved build performance. Ensure your project configuration includes Turbopack settings and test your build pipeline to confirm compatibility with the new default.