Setting up a React Project with Vite: A Step-by-Step Guide
Published: 2023-05-15 17:28:57

**OUTLINE**

- Introduction
- Prerequisites
- Setting up a React Project with Vite
- Conclusion


## **Introduction**

React is a JavaScript library developed by Facebook that allows developers to build reusable UI components and efficiently update them, resulting in fast and responsive web applications. 

Vite is a fast build tool and development server that is designed to enhance the development experience for modern web applications. It is designed to offer quick hot module replacement (HMR) and efficient build times by utilizing native ES modules, which makes it highly compatible and ideal for frameworks such as React, Vue.js, and others.


In this step-by-step guide, we will explain the process of setting up a React project using Vite, following the official Vite documentation.


## **Prerequisites**

Before you begin ensure that Node.js and NPM are installed on your system. You can check if you have these installed by running the following commands in your terminal:

```
node -v
npm -v
```

If the version numbers are not returned by these commands, download and install Node.js from the official website.


## **Setting up a React Project with Vite**

**STEP 1: Create a new React project**

Open your terminal and navigate to the directory where you want to create your new React project. Run the following command to create a new React project using Vite's template:

```
npx create-vite@latest my-react-app --template react

```
This command will create a new directory named ‘my-react-app’ and initialize a React project using the Vite template for React. After the command has been executed, navigate to the newly created project directory and run the following command;

```
cd my-react-app

```

**STEP 2: Installing dependencies**

Install the project dependencies by running the following command:

```
npm install
```

This command will create a `package.json` file and install all the required dependencies specified in it.

**STEP 3: Running the development server**

To start the development server, run the following command:

```
npm run dev
```

This command will compile your React code and launch the development server. You should see the following output in your terminal:

```
> my-react-app@0.0.0 dev
> vite

  VITE v4.3.5  ready in 1225 ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
  ➜  press h to show help
```

Click on the link `http://localhost:3000/` which will open up your default web browser and, your React application will be up and running.

**STEP 4: Building for production**

When your development is complete and you are ready to deploy your React application to a production environment, you need to build it. To build your React application, run the following command:

```
npm run build
```

This command will compile and bundle your React code into optimized static assets and place them in the `dist` directory.

**STEP 5: Serving the production build locally**

Once the build is complete, you can serve the optimized production build locally to ensure everything is working as expected. Run the following command to serve the production build:

```
npm run preview
```

This command will start the Vite server, serving the production build at `http://localhost:4173/`. Open your browser and navigate to the provided URL to see your React application running in the production environment.


## Conclusion

Setting up a React project with Vite offers the benefits such as a lightning-fast development server, optimized builds, simplified configuration, compatibility, etc., resulting in a highly efficient and productive development experience.

By following the steps outlined in this guide, you have successfully created a new React project using Vite, set up the development server, built your application for production, and served the optimized build.