purr react is a simple boilerplate to build web application using React and Webpack. It comes with some good modern technologies like webpack-dev-server, eslint, babel... .
There are a lot of react boilerplates everywhere but I've never been able to find one that isn't too overkill. Create React App is good for creating apps without build configuration but it completly hides the build config. You can eject
the build config but you'll loose interest in using Create React App.
purr-react was designed to make the process of creating simple react apps easier without the need of redux or anything too overkill for a small project. You can extend the config as much as you want.
- Easy as pie - run one of the easiest React boilerplate without much knowledge
- Instant feedback - hot reload your browser each time you save a file
- Automated production build -
yarn build
ornpm run build
to build your app. - Next gen JS - want to write ES8? Do it! Webpack will make it es5 ready for you.
- Shiny styles - use ES6 and CSS to style your app with styled-components 💅 It will also improve performances by rendering only the styles that are on the pages.
- React routing -
react-router-dom
will be your best friend to create your awesome/about
page, thanks to routing. - Improved cache - your external project dependencies will be cached and service workers ready.
- Continuous Integration - AppVeyor and TravisCI are ready to catch problems and will test everything on Unix and Windows.
This app also uses some good technologies:
- Babel
- ESlint (with the badass airbnb config)
- Jest
- stylelint
- npm scripts
- Webpack
- Clone this repo using
git clone https://github.com/Manoz/purr-react.git
and move to the directory:cd purr-react
- Run
yarn setup
ornpm run setup
to start the setup process and install dependencies - Run
yarn start
ornpm run start
to see the demo app athttp://localhost:3000
- Run
yarn remove-demo
ornpm run remove-demo
to delete the demo app
If you don't want to use the setup script you can run yarn install
or npm install
after cloning the repo and keep everything in place.
Here is some additional commands you can also use:
yarn build
ornpm run build
: to build the production app inside the*./build*
folder.yarn test
ornpm run test
to test the built app
More information about the npm scripts can be found here.
The documentation for this project is not perfect for now but I'll add more content in the future and maybe a Wiki.
You can learn more about purr-react here.
Released under the MIT license.