К основному содержанию
правило CX Codex

bundle-barrel-imports — правило Claude Code: что делает и установка

Правило bundle-barrel-imports для Claude Code подсказывает импортировать модули напрямую, а не через barrel-файлы. Указывает прямые пути модулей в React-пакетах и библиотеках с большим числом реэкспортов.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/bundle-barrel-imports.md
Открыть на GitHub

Что делает bundle-barrel-imports

bundle-barrel-imports проверяет импорт из библиотек и направляет к прямым путям исходных модулей. Вместо import { Button } from '@mui/material' правило предлагает import Button from '@mui/material/Button'. Так в граф загрузки попадают только нужные модули.

Правило также описывает настройку optimizePackageImports для Next.js 13.5+, при которой можно оставить привычные barrel-импорты. В списке затронутых библиотек есть lucide-react, @mui/material, lodash, date-fns и rxjs.

Для внешней библиотеки tree-shaking не помогает: сборщик не может оптимизировать её содержимое. Поэтому прямые импорты особенно важны, если пакет не попадает в бандл.

Какие задачи решает

  • находить импорты через barrel-файлы
  • заменять реэкспорты прямыми путями
  • сокращать число загружаемых модулей
  • настраивать импорты пакетов в Next.js

Примеры запросов агенту

  • Проверь импорты в проекте и замени barrel-файлы прямыми путями.
  • Найди импорты из @mui/material и предложи безопасные прямые варианты.
  • Проверь, можно ли включить optimizePackageImports для lucide-react в next.config.js.

Как установить bundle-barrel-imports

Вручную: положить файлы

.claude/rules/bundle-barrel-imports.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о bundle-barrel-imports

Как установить bundle-barrel-imports в Claude Code?

Добавьте правило по пути .claude/rules/bundle-barrel-imports.md.

Что делает bundle-barrel-imports?

Правило помогает не загружать тысячи неиспользуемых модулей через barrel-файлы и подсказывает прямые импорты из исходных файлов.

Почему tree-shaking не всегда решает проблему barrel-импортов?

Для внешней библиотеки сборщик не может оптимизировать содержимое. Если включить её в бандл ради tree-shaking, анализ всего графа модулей замедляет сборку.

Исходный текст

bundle-barrel-imports.md · MIT
---
title: Avoid Barrel File Imports
impact: CRITICAL
impactDescription: 200-800ms import cost, slow builds
tags: bundle, imports, tree-shaking, barrel-files, performance
---

## Avoid Barrel File Imports

Import directly from source files instead of barrel files to avoid loading thousands of unused modules. **Barrel files** are entry points that re-export multiple modules (e.g., `index.js` that does `export * from './module'`).

Popular icon and component libraries can have **up to 10,000 re-exports** in their entry file. For many React packages, **it takes 200-800ms just to import them**, affecting both development speed and production cold starts.

**Why tree-shaking doesn't help:** When a library is marked as external (not bundled), the bundler can't optimize it. If you bundle it to enable tree-shaking, builds become substantially slower analyzing the entire module graph.

**Incorrect (imports entire library):**

```tsx
import { Check, X, Menu } from 'lucide-react'
// Loads 1,583 modules, takes ~2.8s extra in dev
// Runtime cost: 200-800ms on every cold start

import { Button, TextField } from '@mui/material'
// Loads 2,225 modules, takes ~4.2s extra in dev
```

**Correct (imports only what you need):**

```tsx
import Check from 'lucide-react/dist/esm/icons/check'
import X from 'lucide-react/dist/esm/icons/x'
import Menu from 'lucide-react/dist/esm/icons/menu'
// Loads only 3 modules (~2KB vs ~1MB)

import Button from '@mui/material/Button'
import TextField from '@mui/material/TextField'
// Loads only what you use
```

**Alternative (Next.js 13.5+):**

```js
// next.config.js - use optimizePackageImports
module.exports = {
  experimental: {
    optimizePackageImports: ['lucide-react', '@mui/material']
  }
}

// Then you can keep the ergonomic barrel imports:
import { Check, X, Menu } from 'lucide-react'
// Automatically transformed to direct imports at build time
```

Direct imports provide 15-70% faster dev boot, 28% faster builds, 40% faster cold starts, and significantly faster HMR.

Libraries commonly affected: `lucide-react`, `@mui/material`, `@mui/icons-material`, `@tabler/icons-react`, `react-icons`, `@headlessui/react`, `@radix-ui/react-*`, `lodash`, `ramda`, `date-fns`, `rxjs`, `react-use`.

Reference: [How we optimized package imports in Next.js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)

© tech-leads-club · MIT · tech-leads-club/agent-skills

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
bundle-dynamic-imports jarrodwatts bundle-dynamic-imports — правило для Claude Code, которое предписывает загружать тяжёлые компоненты через next/dynamic с отключённым SSR, если они не нужны при первой отрисовке. Это уменьшает стартовый бандл и ускоряет первую отрисовку. CX Codex +1 ★ 1 064звёзд репо bundle-size-optimization aj-geddes Скилл bundle-size-optimization помогает уменьшить размер JS и CSS бандлов через разделение кода и tree shaking. Пригодится при настройке сборки или после добавления тяжёлых зависимостей. CX Codex +1 569установок imports-design-system-folder alexj11324 Правило imports-design-system-folder для Claude Code запрещает прямой импорт UI-библиотек в код приложения. Все компоненты направляются через каталог дизайн-системы. CX Codex +1 ★ 88звёзд репо next-bundle-optimizer vercel Скилл next-bundle-optimizer для Claude Code и других агентов: аудирует начальную загрузку Next.js, находит медленные маршруты, раздутые клиентские бандлы и дублирующиеся зависимости. CX Codex +1 4 800установок configuring-imports celigo Скилл configuring-imports для Claude Code и других агентов — настраивает импорты Celigo: выбор адаптера, лукапы, upsert и запись записей во внешние системы. CX Codex +1 4 100установок nextjs-bundle-analyzer davila7 Слэш-команда nextjs-bundle-analyzer для Claude, которая разбирает размер бандла Next.js и подсказывает, что урезать. CX Codex +1 560установок

Из того же набора130

Весь набор →
rendering-usetransition-loading Правило rendering-usetransition-loading для Claude Code переводит индикатор загрузки в React-компонентах с ручного useState на useTransition. Спиннер живёт на отдельном флаге — правило его убирает. CX Codex +1 ★ 7 191звёзд репо server-cache-react Правило server-cache-react учит ассистента мемоизировать серверные запросы через React.cache() и избегать повторных обращений к базе данных. CX Codex +1 ★ 7 191звёзд репо architecture-avoid-boolean-props Правило architecture-avoid-boolean-props запрещает раздувать компоненты булевыми пропсами и предлагает собирать варианты через композицию. Пригодится при проектировании React-компонентов. CX Codex +1 ★ 7 191звёзд репо rendering-hydration-no-flicker Правило rendering-hydration-no-flicker учит агента читать локальное хранилище без ошибок серверного рендеринга и без мигания интерфейса до гидратации. CX Codex +1 ★ 7 191звёзд репо patterns-explicit-variants Правило patterns-explicit-variants требует собирать каждый режим компонента отдельным компонентом вместо набора булевых пропсов. По вызову сразу видно, что отрисуется. CX Codex +1 ★ 7 191звёзд репо async-suspense-boundaries Правило async-suspense-boundaries направляет Claude Code выносить загрузку данных в отдельные компоненты с Suspense, чтобы каркас страницы рендерился без задержек. CX Codex +1 ★ 7 191звёзд репо architecture-compound-components Правило architecture-compound-components предлагает собирать сложные компоненты из частей с общим контекстом. Оно пригодится, когда монолитный компонент обрастает условиями и render props. CX Codex +1 ★ 7 191звёзд репо state-decouple-implementation Правило state-decouple-implementation для Claude Code: провайдер управляет стейтом, UI-компонент знает только интерфейс контекста. Одна смена провайдера — useState, Zustand или серверный sync — не трогает ни одного UI-компонента. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой