giuseppe-trisciuoglio/developer-kit / plugins/developer-kit-typescript/skills/nextjs-performance
nextjs-performance
VerifiedExpert Next.js performance optimization skill covering Core Web Vitals, image/font optimization, caching strategies, streaming, bundle optimization, and Server Components best practices. Use when optimizing Next.js applications for Core Web Vitals (LCP, INP, CLS), implementing next/image and next/font, configuring caching with unstable_cache and revalidateTag, converting Client Components to Server Components, implementing Suspense streaming, or analyzing and reducing bundle size. Supports Next.js 16 + React 19 patterns.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.4 KB |
| references/api-routes.md | markdown | 4.7 KB |
| references/bundle-optimization.md | markdown | 4.5 KB |
| references/caching-strategies.md | markdown | 7.1 KB |
| references/core-web-vitals.md | markdown | 5.4 KB |
| references/font-optimization.md | markdown | 6.6 KB |
| references/image-optimization.md | markdown | 7.2 KB |
| references/metadata-seo.md | markdown | 4.2 KB |
| references/nextjs-16-patterns.md | markdown | 5.4 KB |
| references/server-components.md | markdown | 8.3 KB |
| references/streaming-suspense.md | markdown | 5.2 KB |
references/bundle-optimization.md
View on GitHub# Bundle Optimization
## Overview
Ottimizzazioni per ridurre il JavaScript bundle e migliorare i tempi di caricamento.
---
## Code Splitting
### Dynamic Imports
```typescript
// BEFORE - Import statico, sempre nel bundle
import HeavyChart from './HeavyChart'
export default function Dashboard() {
return <HeavyChart />
}
// AFTER - Lazy loaded
import dynamic from 'next/dynamic'
const HeavyChart = dynamic(() => import('./HeavyChart'), {
loading: () => <ChartSkeleton />,
ssr: false, // Disabilita SSR se necessario
})
export default function Dashboard() {
return <HeavyChart />
}
```
### Condizionale Loading
```typescript
'use client'
import dynamic from 'next/dynamic'
const MapComponent = dynamic(() => import('./Map'), {
ssr: false,
loading: () => <MapPlaceholder />,
})
export function LocationSection({ showMap }: { showMap: boolean }) {
// Componente caricato solo quando showMap è true
return showMap ? <MapComponent /> : null
}
```
### Import con Named Exports
```typescript
const DynamicComponent = dynamic(
() => import('./components').then((mod) => mod.HeavyChart),
{
loading: () => <Loading />,
}
)
```
---
## Tree Shaking
### Export Named vs Default
```typescript
// ✅ SÌ: Named exports per tree shaking
export { Button, Input, Select }
// ❌ NON: Tutto in un oggetto
export default { Button, Input, Select }
// ❌ NON: Re-export wildcards
export * from 'lodash' // Importa tutto lodash
// ✅ SÌ: Import specifici
import { debounce } from 'lodash-es'
```
### Package.json Side Effects
```json
{
"name": "my-lib",
"sideEffects": false,
"exports": {
".": {
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
}
}
}
```
---
## Bundle Analysis
### `@`next/bundle-analyzer
```bash
npm install --save-dev @next/bundle-analyzer
```
```javascript
// next.config.js
const withBundleAnalyzer = require('@next/bundle-analyzer')({
enabled: process.env.ANALYZE === 'true',
})
module.exports = withBundleAnalyzer({
// config
})
```
```bash
ANALYZE=true npm run build
```
---
## Ottimizzazioni Librerie
### Modular Imports (MUI)
```javascript
// next.config.js
module.exports = {
modularizeImports: {
'@mui/material': {
transform: '@mui/material/{{member}}',
},
'@mui/icons-material': {
transform: '@mui/icons-material/{{member}}',
},
lodash: {
transform: 'lodash/{{member}}',
},
},
}
```
### ESM over CommonJS
```typescript
// ❌ NON: CommonJS
const lodash = require('lodash')
// ✅ SÌ: ESM
import { debounce } from 'lodash-es'
// next.config.js per preferire ESM
module.exports = {
experimental: {
esmExternals: true,
},
}
```
---
## Ottimizzazione Dependencies
```bash
# Analizza bundle
npx webpack-bundle-analyzer .next/stats.json
# Trova duplicate dependencies
npx depcheck
# Bundle size check
npm run build 2>&1 | grep -E "(First Load JS|/api)"
```
### next.config.js Ottimizzazioni
```javascript
/** @type {import('next').NextConfig} */
const nextConfig = {
// Ottimizzazione webpack
webpack: (config, { isServer }) => {
// Split chunks più aggressivo
config.optimization.splitChunks = {
chunks: 'all',
cacheGroups: {
vendor: {
test: /[\\/]node_modules[\\/]/,
name: 'vendors',
chunks: 'all',
},
commons: {
name: 'commons',
chunks: 'initial',
minChunks: 2,
},
},
}
return config
},
// Ottimizzazioni build
swcMinify: true,
// Compressione
compress: true,
}
module.exports = nextConfig
```
---
## Best Practices
```typescript
// ✅ SÌ: Lazy load componenti pesanti
const HeavyEditor = dynamic(() => import('./Editor'), { ssr: false })
// ✅ SÌ: Intersection Observer per below-fold
'use client'
import { useEffect, useRef, useState } from 'react'
export function LazyComponent({ component: Component }) {
const [shouldLoad, setShouldLoad] = useState(false)
const ref = useRef(null)
useEffect(() => {
const observer = new IntersectionObserver(([entry]) => {
if (entry.isIntersecting) {
setShouldLoad(true)
observer.disconnect()
}
})
if (ref.current) observer.observe(ref.current)
return () => observer.disconnect()
}, [])
return <div ref={ref}>{shouldLoad ? <Component /> : <Placeholder />}</div>
}
// ✅ SÌ: Prefetch route importante
import Link from 'next/link'
<Link href="/dashboard" prefetch={true}>Dashboard</Link>
// ❌ NON: Prefetch tutto
<Link href="/rarely-used" prefetch={true}>Rare</Link>
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |