Project structure overview in React

Introduction

Organizing your React project helps you find files easily and keeps your code neat. It makes working on your app simpler and faster.

Starting a new React app to keep code clean from the beginning

Working with a team so everyone understands where to put code

Adding new features and wanting to keep related files together

Debugging or updating code and needing to find files quickly

Scaling your app so it stays organized as it grows

Syntax

React

my-react-app/
├── public/
│   ├── index.html
│   └── favicon.ico
├── src/
│   ├── components/
│   │   └── Button.jsx
│   ├── pages/
│   │   └── Home.jsx
│   ├── App.jsx
│   ├── index.jsx
│   └── styles/
│       └── main.css
├── package.json
└── README.md

public/ holds static files like the main HTML page.

src/ contains all React code and styles.

Examples

Separate components and pages into folders for clarity.

React

src/components/Header.jsx
src/components/Footer.jsx
src/pages/About.jsx
src/pages/Contact.jsx
src/App.jsx
src/index.jsx

Static files that the browser loads directly go in public/.

React

public/index.html
public/robots.txt
public/favicon.ico

Keep all CSS files in a styles folder inside src/.

React

src/styles/main.css
src/styles/theme.css

Sample Program

This simple React app shows how files are organized: Greeting.jsx is a component inside components/. App.jsx uses it, and index.jsx starts the app.

React

/* File: src/components/Greeting.jsx */
import React from 'react';

export default function Greeting() {
  return <h1>Hello, welcome to the app!</h1>;
}

/* File: src/App.jsx */
import React from 'react';
import Greeting from './components/Greeting';

export default function App() {
  return (
    <main>
      <Greeting />
    </main>
  );
}

/* File: src/index.jsx */
import React from 'react';
import { createRoot } from 'react-dom/client';
import App from './App';

const container = document.getElementById('root');
const root = createRoot(container);
root.render(<App />);

Important Notes

Keep components small and focused on one job.

Use folders to group related files like components, pages, and styles.

Always name your main entry file index.jsx or index.js for clarity.

Summary

Organizing your React project helps keep code clean and easy to find.

Use folders like components/, pages/, and styles/ inside src/.

The public/ folder holds static files like index.html.

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