With the new synced version release process, we no longer have package-based migration guides, but version-based. Therefore, we removed all old migration guides. Check the old migration guide(new tab) for older guidelines.
This guide should help migrating your Fela codebase to newer versions.
Version 12 is mostly a cleanup and performance update, but it introduces some changes to how plugins work that might require some manual work.
The order in which the plugins need to be executed needs to be adjusted the following:
It previously was in this order:
Note: If you're using fela-preset-web(new tab) that this will be handled automatically.
With Version 10, we did some major changes to all the React-like bindings.
All older APIs should still work, but will now render a deprecation warning with instructions on how to migrate. We will do a code cleanup with Version 11.
Codemods: We also have Codemods to automate the migration process. They should catch at least 80% of all usages.
The FelaTheme component now no longer uses the special
prop to pass a render function, but uses
The same goes for FelaComponent. We now use
directly rather than
. In order to pass a primitive render type, one may now use the
Instead of accepting both
it now only accepts
but allows style objects, rule functions and even an array of both.
component has been renamed to
for more clarity and specificity.