Refract differs from the typical mental model used for React applications. It requires you to adapt your mental model to:
think in reactive programming
systematically think through effects
Thinking reactive will help you think through effects and vice versa. This change of paradigm requires time, but fortunately Refract can be adopted gradually: you can initially use it where it is most obvious, and discover over time more and more use cases.
Reactive programming is renowned for being challenging to learn. It requires a different mental model and the vast majority of us have been wired to think of our code imperatively.
If you are new to reactive programming or don't have a library of choice yet, we recommend you look at the different libraries we offer bindings for (RxJS, xstream, Most, callbag) and choose the one you are most comfortable with.
Thinking through effects
Being able to systematically think through effects also requires a change in how you conceive what happens in your application. Mainly, it lets us think about state transitions rather than state.
Instead of thinking "While x is going on, y should be in that state", you need to think "When x happens, y should transition to that state". Let's put this into perspective with a simple example: a registration form. Your form needs to contain the following elements:
A username field which needs to make sure the chosen value isn't already taken.
A submit button which sends a request to an API. While the request is being processed, the form should not be editable.
When not thinking through effects, we would make the following statements:
When a user types characters in the username field, network requests need to be performed to validate the chosen username, while the submitted button is disabled.
When a user clicks on the submit button, the username value should be posted to the API, while both the submitted button and username field are disabled.
Thinking through effects requires you to isolate each action or event from their resulting effect:
On each new character typed in the username field, the form status should transition to 'validating'
When the form status transitions to 'validating', the submit button should be disabled
When the form status transitions to 'validating', a network request should be made to the API for validating the chosen username
When a request to validate the chosen username is sent, any previous request should be cancelled
When the username validation response is received, the form validation status should be updated
When the submit button is clicked, the form status should transition to 'ready'
When the form status transitions to 'ready', the form should be disabled
When the form status transitions to 'ready', a create user request should be sent to the API
When a successful create user response is received from the API, the app should navigate away
When a non successful create user response is received from the API, the form should be enabled AND an error message should be displayed
Thinking through effects actually allows you to decompose any problem in small and discrete pieces.