Retax-Core

This is the core of the retax framework. Its role is to bootstrap your universal react / redux application and to setup everything if you want to use optionnal retax modules.

Using Retax

Check theses projects to learn how to use retax: retax-client or retax-server.

What retax does?

Bootstrapping

When you bootstrap a retax application (whether on client or on server: the code of retax-core is 100% universal), these lifecycle events will happened in order:

• Read the initial app state
  • on the client, from a window.__INITIAL_STATE__
• Read the authentication cookie
  • on the client, from the dom cookie (using js-cookie)
  • on the server, from the request
• Initialize the redux store and initialize a retax reducer
• Run an optionnal hook (set by the user) to allow user to dispatch early actions
• Initialize react-router and do the route matching
• Run an optionnal hook (set by the user) to allow user to dispatch actions impacting rendererd components
• Generate the JSX of the corresponding app
  • on the server, retax-core populate window.__INITIAL_STATE__ with the corresponding initial state.

The rendering is delegated to these modules retax-client or retax-server.

retax-core literally just build the application.

Provide a inversion of control container to retax modules

Your application will be wrapped by a component <RetaxProvider />. This component exposes to its children a IoC container. This allows them to use dependency injection. This is highly used by all retax modules.

FAQ

I don't understand how this library is built

Check builder and builder-ts-library

Typescript support

This project is shipped with typescript typings. If you are using typescript@^1.6, you don't have to do anything, it will detect the definition types automatically.

Thanks

Thanks to remojansen for the project inversify. This project is intensively used by retax-core and allow it to be 100% universal.

License

MIT License (MIT)