File: mesh-gradient.md | Updated: 11/15/2025
Hide navigation
Search
Ctrl K
Home Guides EAS Reference Learn
Reference version
SDK 53
Archive Expo Snack Discord and Forums Newsletter
Expo MeshGradientA module that exposes MeshGradient view from SwiftUI to React Native.
iOS
tvOS
Bundled version:
~0.3.4
Copy page
Terminal
Copy
- npx expo install expo-mesh-gradient
If you are installing this in an existing React Native app
, make sure to install expo
in your project.
import { MeshGradientView } from 'expo-mesh-gradient'; function App() { return ( <MeshGradientView style={{ flex: 1 }} columns={3} rows={3} colors={['red', 'purple', 'indigo', 'orange', 'white', 'blue', 'yellow', 'green', 'cyan']} points={[ [0.0, 0.0], [0.5, 0.0], [1.0, 0.0], [0.0, 0.5], [0.5, 0.5], [1.0, 0.5], [0.0, 1.0], [0.5, 1.0], [1.0, 1.0], ]} /> ); }
Show More
MeshGradientViewType: React.[Element](https://www.typescriptlang.org/docs/handbook/jsx.html#function-component) <ComponentType<[MeshGradientViewProps](https://docs.expo.dev/versions/v53.0.0/sdk/mesh-gradient#meshgradientviewprops) >>
colorsOptional • Type: string[] • Default: []
An array of colors. Must contain columns * rows elements.
columnsOptional • Type: number • Default: 0
Width of the mesh, i.e. the number of vertices per row.
ignoresSafeAreaOptional • Type: boolean • Default: true
Whether to ignore safe areas when positioning the view.
maskOptional • Type: boolean • Default: false
Masks the gradient using the alpha channel of the given children views.
Note: When this option is enabled, all user interactions (gestures) on children views are ignored.
pointsOptional • Type: number[][] • Default: []
An array of two-dimensional points on the mesh. Must contain columns * rows elements.
rowsOptional • Type: number • Default: 0
Height of the mesh, i.e. the number of vertices per column.
smoothsColorsOptional • Type: boolean • Default: true
Whether cubic (smooth) interpolation should be used for the colors in the mesh rather than only for the shape of the mesh.
[ViewProps](https://reactnative.dev/docs/view#props)