nextjs-16

# Next.js 16 Expert

## Overview

Next.js 16 (released October 21, 2025) is a major release with Turbopack as default bundler, Cache Components model, and significant architectural improvements.

## Quick Start

```bash
# Upgrade existing project
bunx @next/codemod@canary upgrade latest

# Or manual upgrade
bun add next@latest react@latest react-dom@latest

# Or new project
bunx create-next-app@latest
```

## Key Features

### 1. Turbopack (Now Default)
- **2-5x faster production builds**
- **Up to 10x faster Fast Refresh**
- Filesystem caching (beta)

To use webpack instead:
```bash
next dev --webpack
next build --webpack
```

### 2. Cache Components
New explicit caching model with `use cache` directive:

```typescript
// next.config.ts
const nextConfig = {
  cacheComponents: true,
};
```

### 3. proxy.ts (Replaces middleware.ts)
Clearer network boundary, runs on Node.js runtime:

```typescript
// proxy.ts
export default function proxy(request: NextRequest) {
  return NextResponse.redirect(new URL('/home', request.url));
}
```

### 4. React Compiler (Stable)
Automatic memoization:

```typescript
// next.config.ts
const nextConfig = {
  reactCompiler: true,
};
```

```bash
bun add babel-plugin-react-compiler@latest
```

### 5. React 19.2 Features
- **View Transitions**: Animate elements in Transitions
- **useEffectEvent**: Extract non-reactive Effect logic
- **Activity**: Background rendering with state preservation

## Version Requirements

| Requirement | Version |
|-------------|---------|
| Node.js | 20.9+ (LTS) |
| TypeScript | 5.1.0+ |
| Chrome/Edge | 111+ |
| Firefox | 111+ |
| Safari | 16.4+ |

## Documentation Structure

This skill contains the complete official Next.js 16 documentation:

### App Router (Recommended)
- [01-app/01-getting-started](01-app/01-getting-started/) - Installation, project structure, layouts, pages
- [01-app/02-guides](01-app/02-guides/) - Authentication, forms, caching, testing, deployment
- [01-app/03-api-reference](01-app/03-api-