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.
If you already use @expo/ui (56.0.3+, Expo SDK 56), no extra package is needed: its community/masked-view component is picked up automatically as a fallback when @rednegniw/masked-view isn't installed.
Both masked-view options require a dev build (Expo Dev Client or bare RN). They won't work in Expo Go; the native renderer will automatically fall back to per-digit opacity fading in those environments.
Hitting an iOS linker error mentioning DebugStringConvertible or Sealable on React Native 0.84+? See Troubleshooting.
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 |
| @expo/ui | >= 56.0.3 | Optional - alternative masked-view source (Expo projects only) |