Project structure overview in React - Performance & Optimization

Performance: Project structure overview

MEDIUM IMPACT

This affects initial page load speed and developer efficiency by influencing bundle size and code splitting.

Organizing React components and assets for optimal loading

React

src/
  components/
    Header.js
    Footer.js
  utils/
    index.js
  assets/
    images/
      bigImage.png
  styles/
    main.css
  App.js (uses React.lazy for heavy components)

Splitting code and assets into folders allows lazy loading and smaller initial bundles, improving load speed.

📈 Performance GainReduces initial bundle size by 30-50%, improving LCP by 200ms

Organizing React components and assets for optimal loading

React

src/
  App.js
  Header.js
  Footer.js
  utils.js
  styles.css
  bigImage.png
  heavyLibrary.js

All files are loaded together without separation, causing a large initial bundle and slower page load.

📉 Performance CostBlocks rendering for 300-500ms on initial load due to large bundle size

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Flat structure with all files loaded upfront	Minimal DOM impact	N/A	High due to large bundle parsing	[X] Bad
Organized structure with code splitting and lazy loading	Minimal DOM impact	N/A	Low due to smaller bundles	[OK] Good

Rendering Pipeline

Project structure affects how code is bundled and loaded, impacting the browser's critical rendering path by controlling when and how resources are fetched and parsed.

→Network

→Parse & Compile

→Style Calculation

→Layout

⚠️ BottleneckNetwork and Parse & Compile stages due to large bundles

Core Web Vital Affected

LCP

This affects initial page load speed and developer efficiency by influencing bundle size and code splitting.

Optimization Tips

1Organize components and assets into folders to enable code splitting.

2Use lazy loading for heavy or non-critical components to reduce initial bundle size.

3Avoid placing all code in a single folder to prevent large blocking bundles.

Performance Quiz - 3 Questions

How does a flat project structure with all React components in one folder affect performance?

A It reduces network requests significantly

B It improves code splitting automatically

C It increases initial bundle size and slows down page load

D It has no impact on performance

DevTools: Network and Performance panels

How to check: Open DevTools, go to Network tab, reload page and observe bundle sizes and load times. Use Performance tab to see parsing and scripting times.

What to look for: Look for large JS files blocking main thread and long scripting times indicating large bundles.

Practice

1. Which folder in a React project usually contains reusable UI pieces like buttons or headers?

easy

A. pages/

B. components/

C. styles/

D. public/

Solution

1. Step 1: Understand folder purposes

   The components/ folder holds reusable UI parts like buttons or headers.

2. Step 2: Compare with other folders

   public/ holds static files, styles/ holds CSS, and pages/ holds full page components.

3. Final Answer:

   components/ -> Option B

4. Quick Check:

   Reusable UI pieces = components/ [OK]

Hint: Reusable UI parts go in components/ folder [OK]

Common Mistakes:

• Confusing public/ with components/
• Putting styles in components/
• Using pages/ for small UI parts

2. Which file is typically found inside the public/ folder in a React project?

easy

A. index.html

B. Button.jsx

C. App.js

D. styles.css

Solution

1. Step 1: Identify public folder role

   The public/ folder holds static files served directly, like index.html.

2. Step 2: Match files to folders

   App.js and Button.jsx are source code files, styles.css is usually in styles/.

3. Final Answer:

   index.html -> Option A

4. Quick Check:

   Static files like index.html = public/ [OK]

Hint: index.html is always in public/ folder [OK]

Common Mistakes:

• Putting App.js in public/
• Confusing styles.css location
• Thinking Button.jsx is static file

3. Given this React project structure inside src/:

src/
  components/
    Header.jsx
  pages/
    Home.jsx
  styles/
    main.css

Where should you import Header to use it on the home page?

medium

A. import Header from '../components/Header';

B. import Header from './components/Header';

C. import Header from '../pages/Header';

D. import Header from './Header';

Solution

1. Step 1: Locate Home.jsx and Header.jsx relative paths

   Home.jsx is inside pages/, Header.jsx is inside components/ at the same src level.

2. Step 2: Determine correct import path

   From pages/Home.jsx, since pages/ and components/ are sibling folders under src/, go up one level with '..' to src/ then into components/: '../components/Header'.

3. Step 3: Check options carefully

   import Header from './components/Header'; uses './components/Header' which assumes components inside pages/, which is incorrect. import Header from '../components/Header'; uses '../components/Header' which is correct.

4. Final Answer:

   import Header from '../components/Header'; -> Option A

5. Quick Check:

   Relative import from pages to components = ../components/Header [OK]

Hint: Use ../ to go up one folder from pages to src [OK]

Common Mistakes:

• Using ./components from pages/
• Importing from pages/ folder
• Forgetting relative path syntax

4. You see this import in a React file:
import styles from './styles.css';
But the styles folder is inside src/, at the same level as components/, and the file is inside src/components/. What is wrong?

medium

A. The import should be './styles/styles.css' instead

B. You cannot import CSS files in React

C. The import path should be '../styles/styles.css' to go up one folder

D. The styles folder should be inside components/

Solution

1. Step 1: Understand folder locations

   The file is in src/components/, styles folder is in src/. To import styles.css inside styles/, you must go up one level from components/.

2. Step 2: Fix import path

   Using './styles.css' looks for styles.css inside components/, which is wrong. The correct path is '../styles/styles.css'.

3. Step 3: Check options

   The import path should be '../styles/styles.css' to go up one folder correctly identifies the need to go up one folder into the styles folder. You cannot import CSS files in React is false (CSS can be imported). The import should be './styles/styles.css' instead looks inside components/. The styles folder should be inside components/ suggests wrong folder placement.

4. Final Answer:

   The import path should be '../styles/styles.css' to go up one folder -> Option C

5. Quick Check:

   Go up one folder to access styles folder [OK]

Hint: Use ../ to go up from components to src for styles [OK]

Common Mistakes:

• Using ./ without going up folder
• Thinking CSS can't be imported
• Wrong folder nesting assumptions

5. You want to organize a React project with these goals:
- Keep reusable UI parts separate
- Have full pages grouped
- Store CSS files in one place
- Serve static files like images and index.html

Which folder structure best fits these goals inside src/ and public/?

hard

A. src/ui/, src/screens/, src/css/, public/assets/

B. src/, public/components/, public/pages/, public/styles/

C. src/components/, src/pages/, public/styles/, public/

D. src/components/, src/pages/, src/styles/, public/

Solution

1. Step 1: Match goals to folder roles

   Reusable UI parts go in components/, full pages in pages/, CSS in styles/, static files like images and index.html in public/.

2. Step 2: Evaluate options

   src/components/, src/pages/, src/styles/, public/ matches exactly: src/components/, src/pages/, src/styles/, public/. src/ui/, src/screens/, src/css/, public/assets/ uses non-standard folder names and puts static files in public/assets/ only. src/components/, src/pages/, public/styles/, public/ puts styles in public/, which is not typical. src/, public/components/, public/pages/, public/styles/ puts components and pages in public/, which is incorrect.

3. Final Answer:

   src/components/, src/pages/, src/styles/, public/ -> Option D

4. Quick Check:

   Standard React folders = components, pages, styles, public [OK]

Hint: Use components, pages, styles in src and public for static files [OK]

Common Mistakes:

• Putting CSS in public/
• Using non-standard folder names
• Mixing src and public roles