# bundle-dynamic-imports

bundle-dynamic-imports — правило для Claude Code, которое предписывает загружать тяжёлые компоненты через next/dynamic с отключённым SSR, если они не нужны при первой отрисовке. Это уменьшает стартовый бандл и ускоряет первую отрисовку.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1064 у репозитория
- Автор: jarrodwatts
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jarrodwatts/claude-code-config/tree/HEAD/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md
- Обновлён: 2026-01-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/bundle-dynamic-imports

## Что делает

Правило требует от ассистента откладывать импорт массивных компонентов страницы, которые не нужны в момент первой отрисовки. Вместо прямого `import` для них используется функция `next/dynamic`. Подобный подход выносит вспомогательный код из основного клиентского чанка в отдельные файлы.

В правиле приведён шаблон с динамическим вызовом `import()` и параметром `{ ssr: false }`. Это нужно модулям вроде редакторов кода, работающим только в браузере. Инструкция защищает метрики TTI и LCP от разрастания стартового бандла. Но синтаксис `next/dynamic` рассчитан исключительно на Next.js, поэтому в других сборщиках директива приведёт к ошибке.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/bundle-dynamic-imports.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/bundle-dynamic-imports.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/bundle-dynamic-imports.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/bundle-dynamic-imports.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/bundle-dynamic-imports.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jarrodwatts/claude-code-config/tree/HEAD/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md

## Когда брать
- настроить отложенную загрузку тяжёлых блоков через `next/dynamic`
- убрать вспомогательный код редактора или виджета из основного чанка
- предотвратить ухудшение метрик TTI и LCP из-за раздутого бандла
- отключить серверный рендеринг для сугубо клиентских интерфейсов

## Примеры запросов агенту
- Добавь компонент редактора на страницу статьи через динамический импорт
- Отрефактори импорты в `monaco-panel.tsx`, чтобы тяжёлый модуль не попадал в стартовый бандл
- Сделай отложенную загрузку графиков в панели аналитики без SSR

## Похожие
- [bundle-barrel-imports](https://affpapa.org/nevibecode/rules/bundle-barrel-imports.md) — правило · ★ 7191 у репозитория
- [vite-bundle-optimization](https://affpapa.org/nevibecode/skills/vite-bundle-optimization.md) — скилл · 692 установки
- [react-performance-optimizer](https://affpapa.org/nevibecode/agents/react-performance-optimizer.md) — субагент · 2081 установка
- [next-bundle-optimizer](https://affpapa.org/nevibecode/skills/next-bundle-optimizer.md) — скилл · 4800 установок
- [plugin-bundle-size](https://affpapa.org/nevibecode/skills/plugin-bundle-size.md) — скилл · 4600 установок
- [react-vite-best-practices](https://affpapa.org/nevibecode/skills/react-vite-best-practices.md) — скилл · 3000 установок

Из того же набора: [jarrodwatts/claude-code-config](https://affpapa.org/nevibecode/by/jarrodwatts/claude-code-config.md) — 20 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
