Course contentsShow
← React
Lesson 66 of 2,3962. Setup and Modern ToolingFree lesson

When to Refactor: Signs Your Structure Needs Adjustment

Recognize patterns like deep nesting, circular dependencies, and unclear boundaries that signal it's time to reorganize.

When to Refactor: Signs Your Structure Needs Adjustment

You'll learn to recognize warning signs that your project structure is working against you, not for you.

The Structure Smell Test

Just like code can "smell" when something's wrong, your folder structure can too. As your React app grows, organizational decisions that worked at the beginning can become obstacles. Recognizing these patterns early saves you from painful rewrites later.

Red Flags That Signal Refactoring Time

Deep Nesting Hell

If you're navigating paths like src/components/features/dashboard/widgets/charts/LineChart.jsx, you've gone too deep. When folder depth exceeds 3-4 levels, finding files becomes archaeological work. This often means you're organizing by what things are rather than how they're used together.

Import Path Spaghetti

When you see imports like ../../../utils/helpers or notice the same file being imported from wildly different parts of your app, your structure isn't reflecting actual dependencies. Files that constantly talk to each other should live closer together (remember colocation).

Unclear Boundaries

Can't decide where a new component belongs? If you're debating between three different folders, your structure lacks clear organizing principles. This confusion means your feature-based vs layer-based decision needs revisiting.

The Growing "Common" Folder

When components/common or utils has 50+ files, it's become a junk drawer. These catch-all folders signal you need better categorization—perhaps feature-based folders or more specific shared folders.

Circular Dependencies

If Module A imports Module B which imports Module A, your structure has created a logical loop. This typically means related code got artificially separated.

Key Takeaway: Refactor when navigating your codebase feels harder than it should—deep nesting, confusing imports, unclear file homes, and bloated "common" folders are your early warning system.