By default, a single transition config applies to all animated properties. When you need finer control — for example, a snappy spring for movement but a quick fade for opacity — pass aDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/AppAndFlow/react-native-ease/llms.txt
Use this file to discover all available pages before exploring further.
TransitionMap instead of a single config.
A TransitionMap maps property categories to individual transition configs:
Category keys
| Key | Properties covered |
|---|---|
default | Fallback for any category not explicitly listed in the map |
transform | translateX, translateY, scaleX, scaleY, rotate, rotateX, rotateY |
opacity | opacity |
borderRadius | borderRadius |
backgroundColor | backgroundColor |
Using default as a fallback
When a category is not listed in the map, the library falls back to the default key. If no default key is present either, the library default (timing 300ms easeInOut) applies.
scale and translateY (both in the transform category) use the spring defined under default. opacity uses its own timing config.
When to use per-property vs a single config
| Scenario | Recommendation |
|---|---|
| All properties should move the same way | Single config |
| Opacity should fade faster than transforms spring | Per-property map |
| Background color needs timing while transforms spring | Per-property map |
| You want a global fallback with one override | default + specific key |
On Android,
backgroundColor is animated with ValueAnimator.ofArgb(), which only supports timing transitions. If you specify type: 'spring' for the backgroundColor key, it silently falls back to timing with a 300ms duration.