Barrel Files: Why index.ts Re-Exports Hurt Tree Shaking, Next.js Dev Memory, and tsc (2026)
Scored daily by a customisable AI persona to surface the most relevant engineering leadership news.
Deep dive on barrel files and tree shaking, highly actionable for frontend engineers.
Barrel files (index.ts re-exports) cause three performance problems in modern TypeScript/React development: they undermine tree-shaking by forcing bundlers to load all re-exported modules, bloat Next.js dev server memory and slow tsc runs by creating large module graphs, and introduce circular dependency bugs. A real-world example from @reactuses/core showed a single hook import pulling a 552 kB client chunk that dropped to 64 kB after removing the barrel. The root cause is that a module import is a graph traversal, not a symbol lookup—resolving one export from a barrel forces evaluation of all its children and their transitive dependencies.