Next.js 15 Compatibility Guide: React, TypeScript, and Popular Packages

Next.js 15: New Requirements

Next.js 15 introduced the App Router as default, React Server Components, and updated its dependency requirements. Here's what you need to know.

Core Requirements

• React: 18.3+ or 19.x (Next.js 15 supports both, but 19 is recommended)
• React DOM: Must match React version exactly
• TypeScript: 5.0+ (5.3+ recommended)
• Node.js: 18.17+ (20.x recommended)

What Works with Next.js 15

• @tanstack/react-query 5.x — Fully compatible, works with Server Components
• zustand 4.x+ — Compatible, client components only
• tailwindcss 3.x+ — Works perfectly
• next-auth 5.x (Auth.js) — Designed for Next.js 15
• prisma — Framework-agnostic, works in API routes and Server Components

What Needs Updates

• next-i18next — Use next-intl instead for App Router
• next-seo — Use Next.js built-in metadata API instead
• @mui/material — Needs "use client" directive, compatible but requires client boundary
• styled-components — Requires compiler config in next.config.js

Check Your Stack

Check Next.js 15 + React 18 compatibility or scan your full package.json for a complete report.