siygle/react-boilerplate

Start your next react project in seconds

A highly scalable, offline-first foundation with the best DX and a focus on performance and best practices

_{Made with ❤︎ by Max Stoiber and contributors. If you're using this boilerplate, we'd love to hear from you!}

Features

Quick scaffolding: Create components, containers, routes, selectors and sagas - and their tests - right from the CLI!
Instant feedback: Enjoy the best DX (Developer eXperience) and code your app at the speed of thought! Your saved changes to the CSS and JS are reflected instantaneously without refreshing the page. Preserve application state even when you update something in the underlying code!
Predictable state management: Unidirectional data flow allows for change logging and time travel debugging.
Next generation JavaScript: Use template strings, object destructuring, arrow functions, JSX syntax and more, today.
Next generation CSS: Write composable CSS that's co-located with your components for complete modularity. Unique generated class names keep the specificity low while eliminating style clashes. Ship only the styles that are on the page for the best performance.
Industry-standard routing: It's natural to want to add pages (e.g. `/about`) to your application, and routing makes this possible.
Offline-first: The next frontier in performant web apps: availability without a network connection from the instant your users load the app.

But wait... there's more!

The best test setup: Automatically guarantee code quality and non-breaking changes. (Seen a react app with 99% test coverage before?)
Native web app: Your app's new home? The homescreen of your users' phones.
The fastest fonts: Say goodbye to vacant text.
Stay fast: Profile your app's performance from the comfort of your command line!
Catch problems: AppVeyor and TravisCI setups included by default, so your tests get run automatically on Windows and Unix.

_{Keywords: React.js, Redux, Hot Reloading, ESNext, Babel, PostCSS, Autoprefixer, react-router, Offline First, ServiceWorker, CSS Modules, redux-saga, FontFaceObserver, PageSpeed Insights}

Quick start

Clone this repo using $ git clone --depth=1 https://github.com/mxstbr/react-boilerplate.git
Run $ npm run setup to install dependencies and clean the git repo.
At this point you can run $ npm start to see the example app at http://localhost:3000.
Run $ npm run clean to delete the example app.

Now you're ready to rumble!

Documentation

Intro: What's included and why
Commands: Getting the most out of this boilerplate
Testing: How to work with the built-in test harness
Styling: How to work with the CSS tooling
Your app: Supercharging your app with Routing, Redux, simple asynchronicity helpers, etc.