building-nextjs-apps

Apply Next.js 16 best practices to new and migrating projects.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/hafiznaveedchuhan-ctrl/hackaton2pages --skill building-nextjs-apps-hafiznaveedchuhan-ctrl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building-nextjs-apps
Source: https://github.com/hafiznaveedchuhan-ctrl/hackaton2pages/tree/main/.claude/skills/building-nextjs-apps
Command: npx skills add https://github.com/hafiznaveedchuhan-ctrl/hackaton2pages --skill building-nextjs-apps-hafiznaveedchuhan-ctrl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provide clear Next.js 16 migration and implementation guidance to ensure projects follow official patterns, avoid breaking changes, and maximize performance.

Core Features & Use Cases

  • Covers Next.js 16 breaking changes (async params, searchParams)
  • Guides on implementing proxy.ts (replacing middleware.ts), App Router patterns, dynamic routes, and parallel routes
  • Includes Turbopack defaults, cacheComponents, and updated image usage patterns
  • Provides migration checklists, code examples, and project structure guidance

Quick Start

Install or upgrade a Next.js 16 project following the patterns and configurations outlined in this guide.

Frequently Asked Questions about building-nextjs-apps

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

FAQPage Schema
How do I migrate a Next.js 15 app to Next.js 16 and handle breaking changes?

To migrate a Next.js 15 app to Next.js 16, handle breaking changes by adopting async params and searchParams, enabling Turbopack defaults, and configuring cacheComponents. This ensures your upgraded project follows official patterns and avoids runtime errors.

What is the Next.js 16 proxy.ts file and how does it replace middleware.ts?

The Next.js 16 proxy.ts file replaces middleware.ts to handle request interception and routing logic. Implementing proxy.ts follows updated Next.js 16 best practices, ensuring proper App Router patterns and project structure configuration.

How do I use parallel routes and dynamic routes in the Next.js App Router?

Parallel routes and dynamic routes in the Next.js App Router are implemented using specific folder conventions for rendering multiple UI segments simultaneously. Following Next.js 16 patterns ensures correct route handler usage and updated project structure.

Does Next.js 16 use Turbopack by default and how do I configure cacheComponents?

Next.js 16 uses Turbopack defaults to maximize build performance, and cacheComponents must be explicitly configured in your next.config file. Applying these updated Next.js configurations ensures optimal rendering and caching behaviors.

What are the updated image usage patterns in Next.js 16?

Updated image usage patterns in Next.js 16 require adjusting image component imports and configurations to align with new caching and rendering behaviors. Implementing these patterns correctly avoids breaking changes during migration.