Skip to content

retaxJS/retax-core

Repository files navigation

Retax-Core

Join the chat at https://gitter.im/hourliert/retax Build Status Version codecov.io

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)

About

Universal React Redux Framework Core

Resources

License

Stars

Watchers

Forks

Packages

No packages published