Nutella with Pepperoni and Mushrooms
Need private packages and team management tools?Check out npm Teams »


0.0.5 • Public • Published


React Native Version Notice

This library will be useful for React Native versions below v0.57. For v0.57 and beyond, React Native supports Android overflow natively from this commit.


The problem is that a parent View in Android will clip the content of children Views (react-native)

This solves the problem of Overflow on Android (check this

This could make code simpler, so you don't need to move some Components outside parents to make layout work

You can read more about the motivation and this package here

Getting started

Steps to (mostly) automatically install react-native-view-overflow

If you are using react-native >=0.60.0

$ npm install react-native-view-overflow --save

Otherwise, if you are using react-native <0.60.0

$ npm install react-native-view-overflow --save

$ react-native link react-native-view-overflow


import ViewOverflow from 'react-native-view-overflow';
    <ComponentToEnableOverflow />

Usage with Flatlist

To make this work with FlatList and related components you need to replace CellRendererComponent with ViewOverflow, for example:

  keyExtractor={item =>}
  renderItem={({ item, index }) => (
      <ViewOverflow style={styles.item}>
      // item....

Usage with Animated Views

To make this work in place of an Animated.View, you need to use Animated.createAnimatedComponent to create an animatable version of ViewOverflow. For example:

import ViewOverflow from 'react-native-view-overflow';
const AnimatedViewOverflow = Animated.createAnimatedComponent(ViewOverflow);

You can then use AnimatedViewOverflow in place of Animated.View.

Manual installation

  1. Open up android/app/src/main/java/[...]/
  • Add import com.entria.views.RNViewOverflowPackage; to the imports at the top of the file
  • Add new RNViewOverflowPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':react-native-view-overflow'
    project(':react-native-view-overflow').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-view-overflow/android')
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
      compile project(':react-native-view-overflow')



npm i react-native-view-overflow

DownloadsWeekly Downloads






Unpacked Size

448 kB

Total Files


Last publish


  • avatar