karademada / learning-react Goto Github PK

Tired of complicated starters with 200MB of dependencies which are hard to understand and modify? This is for you!

• React 16
• Webpack 3
• React Router 4
• SASS
• Babel Cli
• Hot Module Reloading
• Jest 21
• Enzyme 3 for testing

• Simple src/index.jsx and src/index.css (local module css).
• Webpack configuration for development (with hot reloading) and production (with minification).
• CSS module loading, so you can include your css by import styles from './path/to.css';.
• Both js(x) and css hot loaded during development.
• Webpack Dashboard Plugin on dev server.

• You'll need to have git and node installed in your system.
• Fork and clone the project:

git clone https://github.com/ReactJSResources/react-webpack-babel.git

• Then install the dependencies:

npm install

• Run development server:

npm start

• Or you can run development server with webpack-dashboard:

npm run dev

Open the web browser to http://localhost:8888/

To run unit tests:

npm test

Tests come bundled with:

• Jest
• Enzyme
• React Test Utils
• React Test Renderer

npm run build

npm run serve:build

Here is an example Nginx config:

server {
	# ... root and other options

	gzip on;
	gzip_http_version 1.1;
	gzip_types text/plain text/css text/xml application/javascript image/svg+xml;

	location / {
		try_files $uri $uri/ /index.html;
	}

	location ~ \.html?$ {
		expires 1d;
	}

	location ~ \.(svg|ttf|js|css|svgz|eot|otf|woff|jpg|jpeg|gif|png|ico)$ {
		access_log off;
		log_not_found off;
		expires max;
	}
}

There is a .eslint.yaml config for eslint ready with React plugin.

To run linting, run:

npm run lint

• styles having /src/ in their absolute path considered part of the application and exported as local css modules.
• other styles considered global styles used by components and included in the css bundle directly.

Please contribute to the project if you know how to make it better, including this README :)