Why is the index.html file in a Vite project almost empty?

In a modern React application built with Vite, the `index.html` file acts as a static shell or "skeleton" for the app. Instead of containing all the page content, it features a single empty ` ` with an ID of "root." This serves as a mounting point where the React engine injects the entire user interface dynamically using JavaScript. Vite places this file in the root directory to treat it as the direct entry point of the application, making the project structure flatter and easier to navigate.

What is the difference between the "public" and "src/assets" folders?

The choice between these folders depends on whether you want Vite to process the file. The `public` folder is a static zone for files like favicons or `robots.txt` that should be served exactly as they are without any changes to their filenames. In contrast, the `src/assets` folder is for resources used directly inside your React components. Vite processes these files by adding unique hashes to their names, which helps with browser caching and ensures users always see the most up-to-date version of an image or asset.

What is the purpose of main.jsx and the createRoot function?

The `main.jsx` file functions as the "brain" or the "handshake" of the application. It is responsible for connecting the JavaScript logic to the HTML shell. It uses the `createRoot` function to locate the "root" div in `index.html` and initialize the React engine on that specific container. Once this connection is established, it calls the `.render()` method to load the top-level component, usually called `App`, into the browser.

Why does Vite require the .jsx extension for React components?

Vite is strict about file extensions to ensure fast and accurate processing of code. If a file contains JSX—the HTML-like syntax used in React—it must use a `.jsx` or `.tsx` extension. If a developer attempts to write JSX inside a plain `.js` file, Vite will throw an error. This discipline allows Vite to efficiently transform the code and provides clear signaling to the build tool about how to handle the contents of each file.

What is "Hot Module Replacement" (HMR) in the development environment?

Hot Module Replacement is a feature triggered when you run the `npm run dev` command. It creates a lightning-fast feedback loop where changes made to your code in an editor like VS Code are reflected in the browser almost instantly without requiring a full page reload. This allows developers to see updates to UI logic or CSS styles in real-time, significantly increasing productivity during the building process.

React project structure is simpler than you think

22 min

Mar 31, 2026

Technology Education Productivity

Struggling to navigate your first Vite project? Learn how the root div and main files connect so you can build your React app with confidence.

Best quote from React project structure is simpler than you think

The 'Skeleton' is basically this: an index.html file that acts as the shell, a 'root' div that acts as the container, and a script tag that invites the JavaScript 'Brain' to come in and start decorating.

Key Takeaways

Inside the Vite Project Skeleton

0:00

Lena: You know, Jackson, I remember the first time I opened a new React project. I expected this massive, intimidating mountain of code, but with Vite, it’s actually surprisingly lean. It’s almost like walking into a house before the furniture arrives—you just see the frame.

0:16

Jackson: That’s a perfect way to put it. A common mistake beginners make is thinking they need to understand every single file immediately, but in 2026, Vite keeps things so lightweight that there are really only three "must-know" files that do the heavy lifting. It’s all about that handshake between your HTML and your JavaScript.

0:34

Lena: Right, and it’s wild that the "brain" of the whole operation starts with just a single empty div in an HTML file. It feels counterintuitive that your entire app lives inside one tiny container.

0:45

Jackson: It really does! We’re going to build a mental map of how that works, starting with the skeleton of the project. Let’s dive into the index.html and that famous root div.

The Skeleton and the Root Div

The Brain and the Handshake

The Face of the Application

The Mystery of Public and Assets

Avoiding the Beginner Potholes

The Practical Playbook for Beginners

Closing Reflection and Your Next Move

This audio lesson was created by a BeFreed community member

Input question

Explain how a Vite + React project is structured for beginners. Cover main.jsx, App.jsx, index.html, root div, and how React renders into the DOM. Keep it conceptual and audio-friendly. No long code. End with 3 recap bullets.

Host voices

Lena

Jackson

Learning style

Fun

Knowledge sources

Learn Python in One Day and Learn It Well

Frequently Asked Questions

More like this

20 sources

From Clutter to Clean: Structuring Your Vite React App

23 min

Accelerate: The Science of Lean Software and DevOps

24 sources

React architecture is more than just code

22 min

The Internet Is Not What You Think It Is

Israel: A Concise History of a Nation Reborn

27 sources

React Essentials: From jQuery Chaos to Modern Web

24 min

27 sources

From Ten Minutes to Thirty Seconds: Vite React

38 min

24 sources

How JSX Works Under the Hood

32 min

Getting Real: The smarter, faster, easier way to build a successful web application

23 sources

Build a React podcast app with full-stack architecture

21 min

Developing Backbone.js Applications

Addy Osmani

8 min

Working in Public

Nadia Eghbal

9 min

From Columbia University alumni built in San Francisco

BeFreed Brings Together A Global Community Of 1,000,000 Curious Minds

See more on how BeFreed is discussed across the web

"Instead of endless scrolling, I just hit play on BeFreed. It saves me so much time."

@Moemenn

"I never knew where to start with nonfiction—BeFreed’s book lists turned into podcasts gave me a clear path."

@Chloe, Solo founder, LA

117

"Perfect balance between learning and entertainment. Finished ‘Thinking, Fast and Slow’ on my commute this week."

@Raaaaaachelw

"Crazy how much I learned while walking the dog. BeFreed = small habits → big gains."

@Matt, YC alum

108

"Reading used to feel like a chore. Now it’s just part of my lifestyle."

@Erin, Investment Banking Associate , NYC

254

"Feels effortless compared to reading. I’ve finished 6 books this month already."

@djmikemoore

"BeFreed turned my guilty doomscrolling into something that feels productive and inspiring."

@Pitiful

4.5K

"BeFreed turned my commute into learning time. 20-min podcasts are perfect for finishing books I never had time for."

@SofiaP

"BeFreed replaced my podcast queue. Imagine Spotify for books — that’s it. 🙌"

@Jaded_Falcon

201

"It is great for me to learn something from the book without reading it."

@OojasSalunke

"The themed book list podcasts help me connect ideas across authors—like a guided audio journey."

@Leo, Law Student, UPenn

483

"Makes me feel smarter every time before going to work"

@Cashflowbubu

From Columbia University alumni built in San Francisco

BeFreed Brings Together A Global Community Of 1,000,000 Curious Minds

See more on how BeFreed is discussed across the web

"Instead of endless scrolling, I just hit play on BeFreed. It saves me so much time."

@Moemenn

"I never knew where to start with nonfiction—BeFreed’s book lists turned into podcasts gave me a clear path."

@Chloe, Solo founder, LA

117

"Perfect balance between learning and entertainment. Finished ‘Thinking, Fast and Slow’ on my commute this week."

@Raaaaaachelw

"Crazy how much I learned while walking the dog. BeFreed = small habits → big gains."

@Matt, YC alum

108

"Reading used to feel like a chore. Now it’s just part of my lifestyle."

@Erin, Investment Banking Associate , NYC

254

"Feels effortless compared to reading. I’ve finished 6 books this month already."

@djmikemoore

"BeFreed turned my guilty doomscrolling into something that feels productive and inspiring."

@Pitiful

4.5K

"BeFreed turned my commute into learning time. 20-min podcasts are perfect for finishing books I never had time for."

@SofiaP

"BeFreed replaced my podcast queue. Imagine Spotify for books — that’s it. 🙌"

@Jaded_Falcon

201

"It is great for me to learn something from the book without reading it."

@OojasSalunke

"The themed book list podcasts help me connect ideas across authors—like a guided audio journey."

@Leo, Law Student, UPenn

483

"Makes me feel smarter every time before going to work"

@Cashflowbubu

"Instead of endless scrolling, I just hit play on BeFreed. It saves me so much time."

@Moemenn

"I never knew where to start with nonfiction—BeFreed’s book lists turned into podcasts gave me a clear path."

@Chloe, Solo founder, LA

117

"Perfect balance between learning and entertainment. Finished ‘Thinking, Fast and Slow’ on my commute this week."

@Raaaaaachelw

"Crazy how much I learned while walking the dog. BeFreed = small habits → big gains."

@Matt, YC alum

108

"Reading used to feel like a chore. Now it’s just part of my lifestyle."

@Erin, Investment Banking Associate , NYC

254

"Feels effortless compared to reading. I’ve finished 6 books this month already."

@djmikemoore

"BeFreed turned my guilty doomscrolling into something that feels productive and inspiring."

@Pitiful

4.5K

"BeFreed turned my commute into learning time. 20-min podcasts are perfect for finishing books I never had time for."

@SofiaP

"BeFreed replaced my podcast queue. Imagine Spotify for books — that’s it. 🙌"

@Jaded_Falcon

201

"It is great for me to learn something from the book without reading it."

@OojasSalunke

"The themed book list podcasts help me connect ideas across authors—like a guided audio journey."

@Leo, Law Student, UPenn

483

"Makes me feel smarter every time before going to work"

@Cashflowbubu

"Instead of endless scrolling, I just hit play on BeFreed. It saves me so much time."

@Moemenn

"I never knew where to start with nonfiction—BeFreed’s book lists turned into podcasts gave me a clear path."

@Chloe, Solo founder, LA

117

"Perfect balance between learning and entertainment. Finished ‘Thinking, Fast and Slow’ on my commute this week."

@Raaaaaachelw

"Crazy how much I learned while walking the dog. BeFreed = small habits → big gains."

@Matt, YC alum

108

"Reading used to feel like a chore. Now it’s just part of my lifestyle."

@Erin, Investment Banking Associate , NYC

254

"Feels effortless compared to reading. I’ve finished 6 books this month already."

@djmikemoore

"BeFreed turned my guilty doomscrolling into something that feels productive and inspiring."

@Pitiful

4.5K

"BeFreed turned my commute into learning time. 20-min podcasts are perfect for finishing books I never had time for."

@SofiaP

"BeFreed replaced my podcast queue. Imagine Spotify for books — that’s it. 🙌"

@Jaded_Falcon

201

"It is great for me to learn something from the book without reading it."

@OojasSalunke

"The themed book list podcasts help me connect ideas across authors—like a guided audio journey."

@Leo, Law Student, UPenn

483

"Makes me feel smarter every time before going to work"

@Cashflowbubu

1.5K Ratings4.7

Start your learning journey, now