/itsquiz-wall

Isomorphic application written in React

Primary LanguageJavaScriptMIT LicenseMIT

Build Status

Isomorphic "Quiz Wall" for itsquiz.com

Motivation

There are a lot of tutorials and boilerplates showing how to write isomorphic ReactJs applications. But when it comes to real world apps, you'll find that all the turorials do not cover problems that you face in productions apps.

In WebbyLab, we have a lot of projects written in react and several isomorphic projects. So, it was decided to develop one of these projects on github. So, everyone can see how real-world production isomorphic app can be implemented.

IMPORTANT: This is production app, and we develop it in this repo. So, it is always evolving.

You can find post from Viktor Turskyi (aka koorchik). Post describes all the ideas in details.

Installation (development)

  1. npm install
  2. cp etc/client-config.json.sample etc/client-config.json (by default connect to production REST API)
  3. npm run webpack-devserver (wait until build is ready, it will create file "etc/webpack-assets.json")
  4. npm run nodemon (in another terminal, and wait until build is ready)
  5. open http://localhost:3001

About the application

Watch the video:

IMAGE ALT TEXT HERE

Solved problems:

  1. How to deal with routing.
  2. How do we deal with data fetching.
  3. How to share the same configuration. (And do not bundle it)
  4. How to import css in your react components. Inline CSS (why not Radium, Material-UI)
  5. How to deal with css. It should be loaded before html and splitted out.
  6. Working with history (Invariant Violation: Browser history needs a DOM)
  7. How to deal with I18N.
  8. How to deal with long term assets caching

Post from Viktor Turskyi (aka koorchik) which describes all the ideas in details.

How to contribute?

  1. Bug reports (pull requests) and ideas how to deal with isomorphic issues are welcome.

  2. We were early adopters of ReactJs and use it from the moment facebook opensourced it. So, almost every project in our company is written in ReactJs. Contact us if you need help.

  3. It's Quiz is a great service and we use it in WebbyLab. Just give us feedback on it.

Architecture description (TODO)

Development guide and conventions (TODO)

Async actions:

{ type: 'FETCH_POSTS_REQUEST' }
{ type: 'FETCH_POSTS_FAILURE', error: 'Oops' }
{ type: 'FETCH_POSTS_SUCCESS', response: { ... } }

License

Thanks

Thanks for http://itsquiz.com (our customer) for allowing opensourcing of this app.