Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/software-mansion/react-native-svg
SVG library for React Native, React Native Web, and plain React web projects.
https://github.com/software-mansion/react-native-svg
Last synced: 2 days ago
JSON representation
SVG library for React Native, React Native Web, and plain React web projects.
- Host: GitHub
- URL: https://github.com/software-mansion/react-native-svg
- Owner: software-mansion
- License: mit
- Created: 2016-01-17T14:29:21.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-07-30T13:07:20.000Z (about 2 months ago)
- Last Synced: 2024-07-30T13:13:25.606Z (about 2 months ago)
- Language: Java
- Homepage:
- Size: 23.2 MB
- Stars: 7,375
- Watchers: 98
- Forks: 1,112
- Open Issues: 184
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-react-native - react-native-svg ★2982 - SVG library that works on both iOS & Android (Components / UI)
- jimsghstars - software-mansion/react-native-svg - SVG library for React Native, React Native Web, and plain React web projects. (Java)
README
[](https://www.npmjs.com/package/react-native-svg)
[](https://www.npmjs.com/package/react-native-svg)
`react-native-svg` provides SVG support to React Native on iOS, Android, macOS, Windows, and a compatibility layer for the web.
[Check out the Example app](https://github.com/react-native-svg/react-native-svg/tree/main/example)
- [Features](#features)
- [Installation](#installation)
- [Troubleshooting](#troubleshooting)
- [Opening issues](#opening-issues)
- [Usage](#usage)
- [Known issues](#known-issues)
## Features
1. Supports most SVG elements and properties (Rect, Circle, Line, Polyline, Polygon, G ...).
2. Easy to [convert SVG code](https://svgr.now.sh/) to react-native-svg.
## Installation
### With expo
> ✅ The [Expo client app](https://expo.io/tools) comes with the native code installed!
Install the JavaScript with:
```bash
npx expo install react-native-svg
```
📚 See the [**Expo docs**](https://docs.expo.io/versions/latest/sdk/svg/) for more info or jump ahead to [Usage](#usage).
### With react-native-cli
1. Install library
from npm
```bash
npm install react-native-svg
```
from yarn
```bash
yarn add react-native-svg
```
2. Link native code
```bash
cd ios && pod install
```
## Supported react-native versions
| react-native-svg | react-native |
| ---------------- | ------------ |
| 3.2.0 | 0.29 |
| 4.2.0 | 0.32 |
| 4.3.0 | 0.33 |
| 4.4.0 | 0.38 |
| 4.5.0 | 0.40 |
| 5.1.8 | 0.44 |
| 5.2.0 | 0.45 |
| 5.3.0 | 0.46 |
| 5.4.1 | 0.47 |
| 5.5.1 | >=0.50 |
| >=6 | >=0.50 |
| >=7 | >=0.57.4 |
| >=8 | >=0.57.4 |
| >=9 | >=0.57.4 |
| >=12.3.0 | >=0.64.0 |
| >=15.0.0 | >=0.70.0 |
## Support for Fabric
[Fabric](https://reactnative.dev/architecture/fabric-renderer) is React Native's new rendering system. As of [version `13.0.0`](https://github.com/react-native-svg/react-native-svg/releases/tag/v13.0.0) of this project, Fabric is supported only for react-native 0.69.0+. Support for earlier versions is not possible due to breaking changes in configuration.
| react-native-svg | react-native |
| ---------------- | ------------ |
| >=13.0.0 | 0.69.0+ |
| >=13.6.0 | 0.70.0+ |
| >=13.10.0 | 0.72.0+ |
## Troubleshooting
### Unexpected behavior
If you have unexpected behavior, please create a clean project with the latest versions of react-native and react-native-svg
```bash
react-native init CleanProject
cd CleanProject/
yarn add react-native-svg
cd ios && pod install && cd ..
```
Make a reproduction of the problem in `App.js`
```bash
react-native run-ios
react-native run-android
```
### Adding Windows support
1. `npx react-native-windows-init --overwrite`
2. `react-native run-windows`
## Opening issues
Verify that it is still an issue with the latest version as specified in the previous step. If so, open a new issue, include the entire `App.js` file, specify what platforms you've tested, and the results of running this command:
```bash
react-native info
```
If you suspect that you've found a spec conformance bug, then you can test using your component in a react-native-web project by forking this codesandbox, to see how different browsers render the same content: If any evergreen browser with significant userbase or other svg user agent renders some svg content better, or supports more of the svg and related specs, please open an issue asap.
## Usage
To check how to use the library, see [USAGE.md](https://github.com/react-native-svg/react-native-svg/blob/main/USAGE.md)
## Known issues:
1. Unable to apply focus point of RadialGradient on Android.
## React Native SVG is maintained by Software Mansion
Since 2012 [Software Mansion](https://swmansion.com) is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – [Hire us](https://swmansion.com/contact/projects?utm_source=svg&utm_medium=readme).