Getting Started
Install Number Flow React Native and its peer dependencies
Installation
Install Reanimated
Add the Reanimated Babel plugin to your babel.config.js (must be listed last):
module.exports = {
plugins: [
// Reanimated v4+
'react-native-worklets/plugin',
// Reanimated v3
// 'react-native-reanimated/plugin',
],
};(Optional) Install Skia
If you want to use the Skia renderer, also install @shopify/react-native-skia:
(Optional) Install MaskedView
For the best visual quality with the native renderer, install @rednegniw/masked-view to enable smooth gradient masking at digit edges. Without it, the native renderer falls back to per-digit opacity fading.
@rednegniw/masked-view requires a dev build (Expo Dev Client or bare RN). It won't work in Expo Go — the native renderer will automatically fall back to per-digit opacity fading in those environments.
Peer Dependencies
| Package | Version | Required |
|---|---|---|
| react | >= 18 | Yes |
| react-native | >= 0.73 | Yes |
| react-native-reanimated | >= 3.0.0 | Yes |
| @shopify/react-native-skia | >= 2.0.0 | Only for Skia components |
| @rednegniw/masked-view | >= 0.4.0 | Optional — smooth gradient masking for native renderer |