Skip to main content

Bundle Dynamic Imports

Source: .agents/references/coding-standard/vercel-react-best-practices/rules/bundle-dynamic-imports.md

Metadata​

  • title: Dynamic Imports for Heavy Components
  • impact: CRITICAL
  • impactDescription: directly affects TTI and LCP
  • tags: bundle, dynamic-import, code-splitting, next-dynamic

Content​

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):

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

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

Correct (Monaco loads on demand):

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} />
}