Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ctrlplusb/react-universally

A starter kit for universal react applications.
https://github.com/ctrlplusb/react-universally

boilerplate progressive-web-app react server-side-rendering starter-kit

Last synced: about 2 months ago
JSON representation

A starter kit for universal react applications.

Host: GitHub
URL: https://github.com/ctrlplusb/react-universally
Owner: ctrlplusb
License: mit
Archived: true
Created: 2016-06-14T21:05:38.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2018-12-26T14:16:47.000Z (over 5 years ago)
Last Synced: 2024-04-24T01:56:03.123Z (5 months ago)
Topics: boilerplate, progressive-web-app, react, server-side-rendering, starter-kit
Language: JavaScript
Homepage:
Size: 2.44 MB
Stars: 1,699
Watchers: 67
Forks: 247
Open Issues: 59
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        


  
React, Universally

  

  A starter kit for universal react applications.


[![All Contributors](https://img.shields.io/badge/all_contributors-20-orange.svg?style=flat-square)](#contributors)

## About

This starter kit contains all the build tooling and configuration you need to kick off your next universal React project, whilst containing a minimal "project" set up allowing you to make your own architecture decisions (Redux/MobX etc).

> NOTICE: Please read this important [issue](https://github.com/ctrlplusb/react-universally/issues/409) about the behaviour of this project when using `react-async-component`, which is by default bundled with it.

## Features

  - 👀 `react` as the view.

  - 🔀 `react-router` v4 as the router.

  - 🚄 `express` server.

  - 🎭 `jest` as the test framework.

  - 💄 Combines `prettier` and Airbnb's ESlint configuration - performing code formatting on commit. Stop worrying about code style consistency.

  - 🖌 Very basic CSS support - it's up to you to extend it with CSS Modules etc.

  - ✂️ Code splitting - easily define code split points in your source using `react-async-component`.

  - 🌍 Server Side Rendering.

  - 😎 Progressive Web Application ready, with offline support, via a Service Worker.

  - 🐘 Long term browser caching of assets with automated cache invalidation.

  - 📦 All source is bundled using Webpack v3.

  - 🚀 Full ES2017+ support - use the exact same JS syntax across the entire project. No more folder context switching! We also only use syntax that is stage-3 or later in the TC39 process.

  - 🔧 Centralised application configuration with helpers to avoid boilerplate in your code. Also has support for environment specific configuration files.

  - 🔥 Extreme live development - hot reloading of ALL changes to client/server source, with auto development server restarts when your application configuration changes.  All this with a high level of error tolerance and verbose logging to the console.

  - ⛑ SEO friendly - `react-helmet` provides control of the page title/meta/styles/scripts from within your components.

  - 🤖 Optimised Webpack builds via HappyPack and an auto generated Vendor DLL for smooth development experiences.

  - 🍃 Tree-shaking, courtesy of Webpack.

  - 👮 Security on the `express` server using `helmet` and `hpp`.

  - 🏜 Asset bundling support. e.g. images/fonts.

  - 🎛 Preconfigured to support development and optimised production builds.

  - ❤️ Preconfigured to deploy to `now` with a single command.

Redux/MobX, data persistence, modern styling frameworks and all the other bells and whistles have been explicitly excluded from this starter kit.  It's up to you to decide what technologies you would like to add to your own implementation based upon your own needs.

> However, we now include a set of "feature branches", each implementing a technology on top of the clean master branch.  This provides you with an example on how to integrate said technologies, or use the branches to merge in a configuration that meets your requirements.  See the [`Feature Branches`](/internal/docs/FEATURE_BRANCHES.md) documentation for more.

## Getting started

```bash

git clone https://github.com/ctrlplusb/react-universally my-project

cd my-project

npm install

npm run develop

```

Now go make some changes to the `Home` component to see the tooling in action.

## Docs

 - [Project Overview](/internal/docs/PROJECT_OVERVIEW.md)

 - [Project Configuration](/internal/docs/PROJECT_CONFIG.md)

 - [Package Script Commands](/internal/docs/PKG_SCRIPTS.md)

 - [FAQ](/internal/docs/FAQ.md)

 - [Feature Branches](/internal/docs/FEATURE_BRANCHES.md)

 - [Deploy your very own Server Side Rendering React App in 5 easy steps](/internal/docs/DEPLOY_TO_NOW.md)

 - [Changelog](/CHANGELOG.md)

## Who's using it and where?

You can see who is using it and how in [the comments here](https://github.com/ctrlplusb/react-universally/issues/437). Feel free to add to that telling us how you are using it, we'd love to hear from you.

## Contributors

Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):

| [
_{Andrés Calabrese}](https://github.com/aoc)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=aoc) | [
_{Andrey Luiz}](https://andreyluiz.github.io/)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=andreyluiz) | [
_{Alin Porumb}](https://github.com/alinporumb)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=alinporumb) | [
_{Benjamin Kniffler}](https://github.com/bkniffler)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=bkniffler) | [
_{Birkir Rafn Guðjónsson}](https://medium.com/@birkir.gudjonsson)
💬 [🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Abirkir) [💻](https://github.com/ctrlplusb/react-universally/commits?author=birkir) 👀 | [
_{Carson Perrotti}](http://carsonperrotti.com)
💬 [💻](https://github.com/ctrlplusb/react-universally/commits?author=carsonperrotti) [📖](https://github.com/ctrlplusb/react-universally/commits?author=carsonperrotti) 👀 | [
_{Christian Glombek}](https://github.com/LorbusChris)
[🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3ALorbusChris) [💻](https://github.com/ctrlplusb/react-universally/commits?author=LorbusChris) |

| :---: | :---: | :---: | :---: | :---: | :---: | :---: |

| [
_{Christoph Werner}](https://twitter.com/code_punkt)
💬 [🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Acodepunkt) [💻](https://github.com/ctrlplusb/react-universally/commits?author=codepunkt) 👀 | [
_{David Edmondson}](https://github.com/threehams)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=threehams) | [
_{Dion Dirza}](https://github.com/diondirza)
💬 [🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Adiondirza) [💻](https://github.com/ctrlplusb/react-universally/commits?author=diondirza) [📖](https://github.com/ctrlplusb/react-universally/commits?author=diondirza) 👀 | [
_{Evgeny Boxer}](https://github.com/evgenyboxer)
[🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Aevgenyboxer) [💻](https://github.com/ctrlplusb/react-universally/commits?author=evgenyboxer) | [
_{Joe Kohlmann}](http://kohlmannj.com)
[🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Akohlmannj) [💻](https://github.com/ctrlplusb/react-universally/commits?author=kohlmannj) | [
_{Lucian Lature}](https://www.linkedin.com/in/lucianlature/)
[🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Alucianlature) [💻](https://github.com/ctrlplusb/react-universally/commits?author=lucianlature) 👀 | [
_{Mark Shlick}](https://github.com/markshlick)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=markshlick) |

| [
_{Ryan Lindskog}](https://www.RyanLindskog.com/)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=rlindskog) | [
_{Steven Enten}](http://enten.fr)
💬 [🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Aenten) [💻](https://github.com/ctrlplusb/react-universally/commits?author=enten) 👀 | [
_{Sean Matheson}](http://www.ctrlplusb.com)
💬 [🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Actrlplusb) [💻](https://github.com/ctrlplusb/react-universally/commits?author=ctrlplusb) [📖](https://github.com/ctrlplusb/react-universally/commits?author=ctrlplusb) 💡 👀 [⚠️](https://github.com/ctrlplusb/react-universally/commits?author=ctrlplusb) 🔧 | [
_{Steven Truesdell}](https://steventruesdell.com)
💬 [🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Astrues) [💻](https://github.com/ctrlplusb/react-universally/commits?author=strues) [📖](https://github.com/ctrlplusb/react-universally/commits?author=strues) [⚠️](https://github.com/ctrlplusb/react-universally/commits?author=strues) | [
_{Thomas Leitgeb}](https://twitter.com/_datoml)
[🐛](https://github.com/ctrlplusb/react-universally/issues?q=author%3Adatoml) [💻](https://github.com/ctrlplusb/react-universally/commits?author=datoml) | [
_{Tyler Nieman}](http://tsnieman.net/)
[💻](https://github.com/ctrlplusb/react-universally/commits?author=tsnieman) |

This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!