react-boilerplate

Boilerplate for new React projects. Includes tooling and configurations.

Why Would You Use This?

Primary use cases are:

• you want to build a project using modern, best practices;
• you want to maintain full control while still keeping things simple without depending entirely on blackbox libraries, such as Create React App.

If you are just learning React, you should instead follow React's recommendations by using Create React App.

Core Concepts

• Fully-configurable
• Based on Best Practices
• Linting rules are not overly strict
• Oriented towards use of hooks
• Accessibility-focused
• Babel-configuration to avoid verbose relative paths
• Husky and lint-staged to force linting/prettification before commit

Key Libraries

• React
• ESLint
• Prettier
• Parcel bundler -- powerful, zero-config bundler
• Reach Router -- small footprint and accessibility-focused
• Emotion CSS-in-js
• React Testing Library -- high-confidence testing library
• Cypress E2E Testing Library -- fast, simple E2E testing library; integrates with React Testing Library

Recommended Libraries Not Included

• Storybook -- install if you want to build UI elements in isolation;
• Gatsby -- blazing fast framework for building static websites. Built with React.
• Next.js -- excellent framework for building static and server-rendered applications. Built with React.
• Typescript - typed JavaScript
• Babel Plugin - Inline React SVG - transform SVG files to React components

Getting Started

• npm install
• npm run dev