ES6 React boilerplate using Webpack

Simple and optimized React boilerplate. It includes:

• React 16.2.0
• ECMAScript 6 and JSX support
• React Router v4
• Component testing using Enzyme and Jest
• Code Coverage
• Latest Webpack (v.4.xx) and Webpack Dev Server (v.3.15) with Scope Hoisting enabled
• Hot Module Replacement using react-hot-loader
• ES6 linting with continuous linting on file change
• SASS support
• Separate CSS stylesheets generation
• Automatic HTML generation
• Production Config
• Custom Babel Preset with Decorators, Class Properties, Rest/Spread operator support
• Export Separate Vendor Files
• Redux

Starting the dev server

Make sure you have the latest Stable or LTS version of Node.js installed.

1. Clone the Project git clone --recurse-submodules https://github.com/tegila/material_base
2. Get inside the folder cd material_base
3. Start docker ecosystem docker-compose up -d

Sometimes the docker don't run all the containers so you can check with docker ps It should list 3 containers [mongo, mongoio, material_base] If the containers aren't running you need run docker-compose up -d again and/or debug...

4. Enjoy http://localhost:8080

Available Commands

• npm start - start the dev server
• npm clean - delete the dist folder
• npm run production - create a production ready build in dist folder
• npm run lint - execute an eslint check
• npm test - run all tests
• npm run test:watch - run all tests in watch mode
• npm run coverage - generate code coverage report in the coverage folder

Vendor Exporting

You can export specific vendors in separate files and load them. All vendors should be included in app/vendors and will be exported in a vendors folder under dist. The main idea is to serve independent JavaScript and CSS libraries, though currently all file formats are supported.

! Don't forget to add the vendors in app/index.html and build/index.html.

Code Coverage

The project is using the Jest Code Coverage tool. The reports are generated by running npm run coverage. All configurations are located in package.json, inside the jest object.

The coverage report consists of an HTML reporter, which can be viewed in the browser and some helper coverage files like the coverage json and xml file.

Production code

Run npm run production. The production-ready code will be located under dist folder.

Licence

react-webpack-boilerplate is available under MIT.