In this document, we will cover installation procedure of react on mac operating system
This guide assumes that you are using macOS. Before you begin, you should have a user account with installation privileges and should have unrestricted access to all mentioned web sites in this document.
This document can be referred by anyone who wants to install latest nodejs on mac
To install react tooling we need nodejs and npm. First let’s understand what these are and why we need them.
Let’s start with nodejs installation post completion on nodejs we will install create-react-app command line and will create a new react project
To access the node and npm executable from terminal make sure /usr/local/bin is in your $PATH. You can verify that by running echo $PATH command in terminal
You should see an output like below (Note: Your version may vary depending on your date of installing as nodejs team make an aggressive release but make sure your node version is > v10.0.0)
You should see an output like below (Note: Your version may vary depending on your date of installing as nodejs team make an aggressive release but make sure your npm version is >5 )
Setting up productive react development environment would need to configure tools like babel, webpack which are complex to configure for a newbie in react world. There are several tools that help to alleviate this problem out of which create react app is the easiest and finest tool with production grade configurations pre-built. The goodness of this tool is, it does not lock in and allows you to alter the configuration by ejecting the create react app.
We will install create-react-app using npm. On terminal run the install command shown below
npm install -g create-react-app
On successful installation you should see the output like above (note your create-react-app version may be different by the time you run this install command)
To test the create-react-app, run below command
Congratulations, you have successfully installed create-react-app
This command creates a new folder named hello-react and creates all the files and setups the necessary libraries within this folder and makes the react project ready to be executed without any additional configuration
npm start command starts webpack development server which in turn performs all the build process and opens a browser window and loads application url which runs at http://www.localhost3000.org/ by default.
You will see a beautiful window like below one which show you the react icon and some text.
As discussed, create react app comes with great tooling, one of the productive features is webpack hot reloading, which deploys the change on live and saves developer lot of time to redeploy and reload work.
Let’s open the project and make some changes to see the experience of this great feature. We will go through the project structure to understand the importance of the file create by create react app.
Open the project which was created in previous step in any JS editor, here you see the project is open in vscode editor. On to the left in explorer section you see file explorer which shows you several folders and files which were created by create-react-app. Let’s walkthrough them.
node_modules: This folder is managed by package manager (npm) and contains all the project library dependencies. Files in this folder should not be modified as the changes made are not guaranteed to be safe as updating/installing any other library can overwrite the changes made.
public: This folder contains the assets that should be served publicly without any restrictions and contains files like index.html, favicon, manifest.json.
src: This is the folder that contains all your development effort. As a react developer you spent lot of time in this folder creating components and other sources of code.
Now let’s get into the files inside this folder. To start with index.js is the starting file of this project where the execution on your code starts, this file injects App component which is exported from App.js. All the output you see in the browser is resultant on this file, lets make some change to this file, we will edit the existing code with new changes as shown in below screenshot.
Save the file and switch back to browser to see the changes deployed and loaded as discussed, this one of the features of create-react-app to tooling setup.
With new changes your browser window should look like below
You can uninstall any library or tool setup via npm install can be uninstalled using npm uninstall. Perform below step to remove create-react-app installed previously