npmpackage.info

Gathering detailed insights and metrics for react-native-linear-gradient

Other packages similar to react-native-linear-gradient

react-native-web-linear-gradient

1.1.2

React Native for Web implementation of react-native-linear-gradient

react-native-linear-gradient-degree

0.0.1

Transform css linear-gradient degree to start and end coordinates in react-native-linear-gradient or expo-linear-gradient

expo-linear-gradient

14.1.5

Provides a React component that renders a gradient view.

primeton-react-native-linear-gradient

2.0.2

Gathering detailed insights and metrics for react-native-linear-gradient

react-native-linear-gradient - 2.8.3 | npmpackage.info

react-native-linear-gradient

A <LinearGradient /> component for react-native

2.8.3

4,934

MIT

Java

115.23 kB

2.8

Installations

npm install react-native-linear-gradient

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

16.20.2

NPM Version

8.19.4 Pull Requests

Open

10

Total

238

Closed

58

Merged

170

Issues

Open

170

Total

447

Closed

277

Releases

2.8.3

v2.8.3

Updated on Sep 06, 2023

3.0.0-alpha.1

v3.0.0-alpha.1

Updated on Aug 11, 2023

3.0.0-alpha.0

v3.0.0-alpha.0

Updated on Aug 10, 2023

2.8.2

v2.8.2

Updated on Aug 07, 2023

2.8.1

v2.8.1

Updated on Jul 28, 2023

2.8.0

v2.8.0

Updated on Jul 23, 2023

View All 18 releases

Languages

Java

C++

JavaScript

Objective-C

Objective-C++

TypeScript

Ruby

CMake

Java (30.18%)

C++ (19.87%)

JavaScript (15.05%)

Objective-C (10.91%)

Objective-C++ (10.24%)

TypeScript (9.8%)

Ruby (3.36%)

C (0.31%)

CMake (0.28%)

Developer

react-native-linear-gradient

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

4,934 Stars

540 Commits

702 Forks

44 Watchers

4 Branches

98 Contributors

Updated on Jul 10, 2025

Maintainers

View All 98 Contributors

Package Meta Information

Latest Version

2.8.3

Package Id

react-native-linear-gradient@2.8.3

Unpacked Size

115.23 kB

Size

22.58 kB

File Count

NPM Version

8.19.4

Node Version

16.20.2

Published on

Sep 06, 2023

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

react react-native

Dev Dependencies

@types/react-native flow-bin react react-native

react-native-linear-gradient

A <LinearGradient> element for React Native

Installation
Usage and Examples
Props
Example App
Troubleshooting
Other Platforms

Installation

1yarn add react-native-linear-gradient

Or, using npm: npm install react-native-linear-gradient

Examples

react-native-login is a legacy component which showcases the use of <LinearGradient>.

Simple

The following code will produce something like this:

Example code result

1import LinearGradient from 'react-native-linear-gradient';
2
3// Within your render function
4<LinearGradient colors={['#4c669f', '#3b5998', '#192f6a']} style={styles.linearGradient}>
5  <Text style={styles.buttonText}>
6    Sign in with Facebook
7  </Text>
8</LinearGradient>
9
10// Later on in your styles..
11var styles = StyleSheet.create({
12  linearGradient: {
13    flex: 1,
14    paddingLeft: 15,
15    paddingRight: 15,
16    borderRadius: 5
17  },
18  buttonText: {
19    fontSize: 18,
20    fontFamily: 'Gill Sans',
21    textAlign: 'center',
22    margin: 10,
23    color: '#ffffff',
24    backgroundColor: 'transparent',
25  },
26});

Horizontal gradient

Using the styles from above, set start and end like this to make the gradient go from left to right, instead of from top to bottom:

1<LinearGradient start={{x: 0, y: 0}} end={{x: 1, y: 0}} colors={['#4c669f', '#3b5998', '#192f6a']} style={styles.linearGradient}>
2  <Text style={styles.buttonText}>
3    Sign in with Facebook
4  </Text>
5</LinearGradient>

Text gradient (iOS)

On iOS you can use the MaskedViewIOS to display text with a gradient. The trick here is to render the text twice; once for the mask, and once to let the gradient have the correct size (hence the opacity: 0):

1<MaskedViewIOS maskElement={<Text style={styles.text} />}>
2  <LinearGradient colors={['#f00', '#0f0']} start={{ x: 0, y: 0 }} end={{ x: 1, y: 0 }}>
3    <Text style={[styles.text, { opacity: 0 }]} />
4  </LinearGradient>
5</MaskedViewIOS>

Animated Gradient

Check out the example app (git clone this project, cd into it, npm install, open in Xcode and run) to see how this is done:

Example with extra props

This gif was created using licecap - a great piece of free OSS

Transparent Gradient

The use of transparent color will most likely not lead to the expected result. transparent is actually a transparent black color (rgba(0, 0, 0, 0)). If you need a gradient in which the color is "fading", you need to have the same color with changing alpha channel. Example:

1// RGBA
2
3<LinearGradient colors={['rgba(255, 255, 255, 0)', 'rgba(255, 255, 255, 1)']} {...otherGradientProps} />
4
5// Hex
6
7<LinearGradient colors={['#FFFFFF00', '#FFFFFF']} {...otherGradientProps} />

Props

In addition to regular View props, you can also provide additional props to customize your gradient look:

colors

An array of at least two color values that represent gradient colors. Example: ['red', 'blue'] sets gradient from red to blue.

start

An optional object of the following type: { x: number, y: number }. Coordinates declare the position that the gradient starts at, as a fraction of the overall size of the gradient, starting from the top left corner. Example: { x: 0.1, y: 0.1 } means that the gradient will start 10% from the top and 10% from the left.

end

Same as start, but for the end of the gradient.

locations

An optional array of numbers defining the location of each gradient color stop, mapping to the color with the same index in colors prop. Example: [0.1, 0.75, 1] means that first color will take 0% - 10%, second color will take 10% - 75% and finally third color will occupy 75% - 100%.

1<LinearGradient
2  start={{x: 0.0, y: 0.25}} end={{x: 0.5, y: 1.0}}
3  locations={[0,0.5,0.6]}
4  colors={['#4c669f', '#3b5998', '#192f6a']}
5  style={styles.linearGradient}>
6  <Text style={styles.buttonText}>
7    Sign in with Facebook
8  </Text>
9</LinearGradient>

Example with extra props

useAngle / angle / angleCenter

You may want to achieve an angled gradient effect, similar to those in image editors like Photoshop. One issue is that you have to calculate the angle based on the view's size, which only happens asynchronously and will cause unwanted flickr.

In order to do that correctly you can set useAngle={true} angle={45} angleCenter={{x:0.5,y:0.5}}, to achieve a gradient with a 45 degrees angle, with its center positioned in the view's exact center.

useAngle is used to turn on/off angle based calculation (as opposed to start/end). angle is the angle in degrees. angleCenter is the center point of the angle (will control the weight and stretch of the gradient like it does in photoshop.

An example app

You can see this component in action in brentvatne/react-native-login.

Troubleshooting

iOS build fails: library not found, "BVLinearGradient" was not found in the UIManager

Ensure to run pod install before running the app on iOS
Ensure you use ios/**.xcworkspace file instead of ios./**.xcodeproj

Other

Clearing build caches and reinstalling dependencies sometimes solve some issues. Try next steps:

Reinstalling node_modules with rm -rf node_modules && yarn
Clearing Android Gradle cache with (cd android && ./gradlew clean)
Reinstalling iOS CocoaPods with (cd ios && rm -rf ./ios/Pods/**) && npx pod-install
Clearing Xcode Build cache (open Xcode and go to Product -> Clean Build Folder)

For other troubleshooting issues, go to React Native Troubleshooting

Other platforms

Web: react-native-web-community/react-native-web-linear-gradient

License

MIT

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

9

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

3

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

1

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:80: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:81: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:69: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/prerelease.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/prerelease.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/prerelease.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/prerelease.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/version.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/version.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/version.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/react-native-linear-gradient/react-native-linear-gradient/version.yml/master?enable=pin
Info: 0 out of 18 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.8

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to react-native-linear-gradient

Other packages similar to react-native-linear-gradient

react-native-linear-gradient

Installations

Developer Guide

Yes

CommonJS

16.20.2

8.19.4

Pull Requests

10

238

58

170

Issues

170

447

277

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

Dev Dependencies

react-native-linear-gradient

Table of Contents

Installation

Examples

Simple

Horizontal gradient

Text gradient (iOS)

Animated Gradient

Transparent Gradient

Props

colors

start

end

locations

useAngle / angle / angleCenter

An example app

Troubleshooting

iOS build fails: library not found, "BVLinearGradient" was not found in the UIManager

Other

Other platforms

License

10

10

9

3

1

0

0

0

0

0

0

0

0

2.8

/10