Back to Sanity

Dynamic Imports for Heavy Components

.agents/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md

5.24.0602 B
Original Source

Dynamic Imports for Heavy Components

Use next/dynamic to lazy-load large components not needed on initial render.

Incorrect (Monaco bundles with main chunk ~300KB):

tsx
import {MonacoEditor} from './monaco-editor'

function CodePanel({code}: {code: string}) {
  return <MonacoEditor value={code} />
}

Correct (Monaco loads on demand):

tsx
import dynamic from 'next/dynamic'

const MonacoEditor = dynamic(() => import('./monaco-editor').then((m) => m.MonacoEditor), {
  ssr: false,
})

function CodePanel({code}: {code: string}) {
  return <MonacoEditor value={code} />
}