/koa-react-starter

A starter kit for building React.JS (with Redux) based applications

Primary LanguageJavaScriptMIT LicenseMIT

Koa React starter

Stack

All Contributors license PRs Welcome Build Status David Dependancy Status

Watch on GitHub Star on GitHub Follow Tweet

Koa React starter is what we think an ideal starting point for the most React.JS frontend applications. It is based on the following primary technologies:

  • react
  • react-router
  • redux
  • webpack
  • postcss
  • eslint
  • koa

Application structured in a way, which we find most efficient in both short and long term projects. The main intention of the current structure is to keep logical components close to each other and define clear structure for the common things, such as routers, store, api wrappers, reducers, action creators, store selectors.

Explanations of the files structure.

  1. src/client/components - this folder consist all UI components. Root level folders (such as profile, index) are typically pages of your application. Every such component should have all files related to the page: images, style files, jsx files, sub components. This folder also consist two none page components: common and layout. Common folder should have all common components which are reused in at least two root level components. Layout - represent a layout of your application and should consist all layout related logic and other components, such as headers, footers, sidebars.
  2. src/client/components/routes.jsx - this file should consist all routes for your client side application.
  3. src/client/helpers - this folder should consist of common helpers used in other components, such as date formatters, api wrappers, validation functions, common functions and all other files that does not fit current structure. If you don't know where to put certain file - put it into this folder and we will eventually figure out the right place for it.
  4. src/client/resources - a folder consist of all redux/api related things. Typically resource maps 1 to 1 to the api endpoint, but not limited to only api endpoints. Every resource is responsible for management certain part of the redux store. If you need keep something client specific in the redux store, you can create separate resource for it. For example: navigation resource may contain some history of the all opened pages without 1 to 1 connection to the rest api. Main moving parts of resource:
  5. src/client/services - folder should consist the logic for the the third party service integrations (such as Intercom, Segment, etc). Not limited only to the third party services, but could consist some standalone application related services.

Important things to keep in mind

  1. Logical components should be tightly coupled. Keep all component related files, such as images, styles, sub components as close as possible to the component. Do not put component into the common folder for the future use.
  2. Two separate page components should be loosely coupled. If there is two page components which use same image - keep two copies of every image within every page. Do not create generic images folder, as all images belong to some ui components.

Conventions

  1. Name of all files for components should start from lowercase letter and words should be separated by a dash (date-range, multi-action-button).
  2. Code style (eslint).

List of planned improvements

  1. Make two current pages stylish.

License

Koa react starter is released under the MIT License.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Join us and share something developers need 👌.

Contributors

Thanks goes to these wonderful people (emoji key):


Evgeny Zhivitsa
💻 📖 🤔 👀
Andrew Orsich
📖 🤔 👀
Uladzimir Mitskevich
🤔 👀

This project follows the all-contributors specification. Contributions of any kind welcome!