Anubhav Sarkar

Setup a React App using Webpack and Babel

Setup a React App using Webpack and Babel

Subscribe to my newsletter and never miss my upcoming articles

Listen to this article

This article is part of a two part series on how to configure a React app from scratch with Webpack and Babel and eventually add TypeScript to it. To read the second article in this series, click on the below link.


So you want to start with a new React app or would like to add React to an already existing project, but don't want to use the create-react-app. Well you have come to the right place. I am here to guide you today on how to setup a react app from scratch with Webpack and Babel.

To create a new react app using Webpack and Babel, the first thing which we would need to install is Node JS. You can install the latest version for your machine by going to this link.

Once you have Node JS installed, we can start with the below steps.

  1. Create a new folder. You could use the following commands to create a new folder. Once the folder is created navigate to the folder using the cd command.

    mkdir <folder_name>
    
    cd <folder_name>
    
  2. While you are inside the folder, create a new package.json file, using the command given below.

    npm init -y
    

    This above command generates a package.json file, no questions asked. You could use the below command to generate the file by manually providing all the information.

    npm init
    

    It asks for these few details at the time of creation.

    a. package name (name for your app)
    b. version (1.0.0 - initially)
    c. description (a small description for your app)
    d. entry point (entry point for the module)
    e. test (any test command)
    f. author (author of the app)
    g. git (git repository url and type)
    h. license (MIT/ ISC etc.)
    
  3. Once the package.json file is created, go ahead and create a 'src' folder. This is where our code will live.

    Now use the touch command to generate these two files:

    touch index.html - (the page which is rendered and visible to the user)
    
    touch index.js - (the entry point for our application)
    
  4. Setup an index.html file with the below code and save it.

    <!DOCTYPE html>
    <html lang="en">
        <head>
            <meta charset="utf-8" />
            <meta name="viewport"
                content="width=device-width, initial-scale=1, shrink-to-fit=no"
            />
            <meta name="theme-color" content="#000000" />
            <title>React with Webpack and Babel</title>
        </head>
        <body>
            <noscript>
                You need to enable JavaScript to run this app.
            </noscript>
            <div id="root">
                <!-- This div is where our app will run -->
            </div>
        </body>
    </html>
    

    Note: The file should look like the screenshot below.

    Leave the index.js as it is for now. We will configure it after installing all the required packages.

    index.html

  5. Now let's add Webpack to our project.

    Install these packages through npm or yarn, whichever you prefer.

    npm install webpack webpack-cli webpack-dev-server --save-dev
    
    • webpack: will be used to configure our app
    • webpack-cli: to use webpack on command line
    • webpack-dev-server: used to live reload the webpage so that we can view our changes without refreshing the page manually.

    Once those packages have been installed, the packages should be visible in the devDependencies section like below.

    package.json

    P.S: You may want to remove the caret(ˆ) from the version of the packages, as we don't know whether the new updates might bring breaking changes or not. It's always better to manually update the versions.

  6. It's time to add a new file again. Use the touch command as you did above to add the webpack.config.js. It should be installed at the root directory.

     touch webpack.config.js
    
  7. Let's go ahead and install the path package as a devDependency since we need to work with paths in our app. We wouldn't want to inject the index.js file inside the HTML file. Go ahead and install the html-webpack-plugin to help us do that automatically.

     npm install path html-webpack-plugin --save-dev
    

    This is how your package.json should look at the moment.

    updated package json

  8. Replace the contents of index.js with the below content.

    (function helloWorld() {
        console.log('Hello World');
    }());
    

    Once this is done, let's run webpack and see what happens. Use the command provided below.

    npm run webpack
    

    Webpack will automatically take the src/index.js file, compile it and output it to dist/main.js and minify the code.

    npm run  webpack

    npm run webpack output

    main js location

    main.js added to dist folder

    We can now go ahead and run the npm start command to run the app.

     npm start
    

    npm start

    npm start output

    Naviage to localhost:8080 and you should be able to see a screen just like below.

    localhost initial

    localhost started on the default browser

    To stop the server press, Ctrl + C on Windows and Command + C on Mac.

  9. Copy the code below and paste it in the webpack.config.js file.

     const path = require("path");
     const HtmlWebpackPlugin = require("html-webpack-plugin");
    
     module.exports = {
         entry: path.join(__dirname, "src", "index.js"),
         output: { path: path.join(__dirname, "build"), filename: "index.bundle.js" },
         mode: process.env.NODE_ENV || "development",
         resolve: { modules: [path.resolve(__dirname, "src"), "node_modules"] },
         devServer: { contentBase: path.join(__dirname, "src") },
         plugins: [
             new HtmlWebpackPlugin({
                 template: path.join(__dirname, "src", "index.html"),
             }),
         ],
     };
    

    webpack config js

    webpack.config.js

    Let's go over the various components in the file.

    • entry and output: tells our server what has to be compiled and from where. Also tells the server where the compiled version should be outputted.

    • mode: this is the mode of our output, which is set to ‘development’ for now. Should be changed to 'production' when the app is build for production.

    • resolve: used so that we can import anything from the src folder in relative paths rather than the absolute ones, same goes for node_modules as well.

    • devServer: this tells the webpack-dev-server what files are needed to be served. Everything from our src folder needs to be served (outputted) in the browser.

    • plugins: here we set what plugins we need in our app. As of this moment we only need the html-webpack-plugin which tells the server that the index.bundle.js should be injected (or added if you will) to our index.html file

      If we now run the earlier command, we will see some differences.

      npm run webpack
      

      npm run webpack

      npm run webpack output

      build folder

      build folder with index.build.js and index.html

    If you start the app now, using the npm start command, you would see a blank screen on the browser, without any content.

     npm start
    

    Open the developer tools on your browser and you should be able to see the entire code of the index.html file in the Elements tab. Check the Console tab to see Hello World logged over there. The webpack-dev-server took everything from the src folder and outputted it to our browser.

  10. We have configured the app to build everything from the src folder and output it to the browser. It's time to add React and spice things up a little.

    Follow the following steps to add React and Babel to the project. Run the following command to add react and react-dom to the project.

    Add react and react-dom as normal dependencies.

      npm install react react-dom --save
    

    At this moment in our development, if we were to add React code inside our JS file, Webpack will give us an error. It doesn’t know how to compile React inside the bundle.js file.

    Modify the index.js file as follows:

    import React from 'react';
    import ReactDOM from 'react-dom';
    
    const HelloWorld = () => {
        return (
            <h1>
                Hello World
            </h1>
        );
    }
    
    ReactDOM.render(<HelloWorld />, document.getElementById("root"));
    

    Let's start the server now and see what is rendered.

    npm start
    

    babel loader error

    webpack error for not having appropriate loaders for react

  11. This is where Babel comes to our aid. Babel will tell Webpack how to compile our React code.

    Let’s add a bunch of Babel packages to our app as devDependencies.

    npm install --save-dev @babel/core @babel/node @babel/preset-env @babel/preset-react babel-loader
    

    Some two pointers about these packages.

If you have reached this step, make sure to remind yourself that you are awesome. You have learned something new today. Have a great day. Thanks for reading the entire thing.

Here's the link to the Github Repo in case you have faced some issue during the entire process. Feel free to make some tweaks if you find something breaking because of updates to any of the packages.

#reactjs#javascript#webpack#babel#typescript
 
Share this