# react-native-fontawesome-pro > Easily use your FontAwesome Pro 5.1 icons in React-Native. Latest version **2.1.0** (published 2019-02-05) · MIT license · 0 weekly downloads ## Install ```sh npm install react-native-fontawesome-pro pnpm add react-native-fontawesome-pro yarn add react-native-fontawesome-pro bun add react-native-fontawesome-pro ``` ## Health **Score 25/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 2.1.0 | | Published | 2019-02-05 | | First published | 2018-02-24 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 1 | | Unpacked size | 132.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 46 | | Author | Yaniv Shnaider | | Maintainers | shyaniv7 | | Keywords | awesome, component, font, font-awesome, fontawesome, icon, react-native, fontawesome-pro, pro | ## Links - npm: https://www.npmjs.com/package/react-native-fontawesome-pro - Repository: https://github.com/shyaniv7/react-native-fontawesome-pro - Homepage: https://github.com/shyaniv7/react-native-fontawesome-pro#readme - Issues: https://github.com/shyaniv7/react-native-fontawesome-pro/issues - npm.io page: https://npm.io/package/react-native-fontawesome-pro ## Dependencies (1) - [@fortawesome/fontawesome-svg-core](https://npm.io/package/@fortawesome/fontawesome-svg-core.md) 1.2.0 ## Alternatives - [@fortawesome/react-fontawesome](https://npm.io/package/@fortawesome/react-fontawesome.md) — 2.2M weekly downloads - [roboto-fontface](https://npm.io/package/roboto-fontface.md) — 196.0K weekly downloads - [@react-native-vector-icons/common](https://npm.io/package/@react-native-vector-icons/common.md) — 150.4K weekly downloads - [@procore/core-icons](https://npm.io/package/@procore/core-icons.md) — 4.6K weekly downloads - [@react-md/material-icons](https://npm.io/package/@react-md/material-icons.md) — 1.6K weekly downloads ## Recent versions - 2.1.0 (latest) — 2019-02-05 - 2.0.1 — 2018-07-15 - 2.0.0 — 2018-07-14 - 1.0.13 — 2018-07-14 - 1.0.12 — 2018-03-05 - 1.0.11 — 2018-02-27 - 1.0.10-alpha — 2018-02-27 - 1.0.9 — 2018-02-26 - 1.0.8 — 2018-02-25 - 1.0.7 — 2018-02-25 - 1.0.6 — 2018-02-25 - 1.0.5 — 2018-02-25 - 1.0.4 — 2018-02-25 - 1.0.3 — 2018-02-25 - 1.0.2 — 2018-02-25 - … 2 more at https://npm.io/package/react-native-fontawesome-pro/versions ## README # react-native-fontawesome-pro Easily use your FontAwesome Pro 5.1 icons in React-Native. v2 of this module takes advantage of [enhancements in FontAwesome 5.1’s JS Package Cleanup](https://fontawesome.com/changelog/latest#enhancements) and provides access to 409 new icons. **Want to install v1?** [View the old readme for FontAwesome Pro 5](https://github.com/shyaniv7/react-native-fontawesome-pro/tree/fcbabb90f197c552aecb9bb5d9a9acb3170ecb080) # Upgrading from v1? If upgrading from a v1 installation uninstall the previous prerequisite FontAwesome packages: npm uninstall --save @fortawesome/fontawesome-free-brands @fortawesome/fontawesome-pro-light @fortawesome/fontawesome-pro-regular @fortawesome/fontawesome-pro-solid or yarn remove @fortawesome/fontawesome-free-brands @fortawesome/fontawesome-pro-light @fortawesome/fontawesome-pro-regular @fortawesome/fontawesome-pro-solid # Installation Prerequisites 1. Create a `.npmrc` file in the root of your project and the line below. Replace `YOUR-TOKEN-HERE` with your FontAwesome Pro token which you can find in your Font Awesome account . More info: [Font Awesome docs: Using a Package Manager](https://fontawesome.com/how-to-use/on-the-web/setup/using-package-managers) @fortawesome:registry=https://npm.fontawesome.com/ //npm.fontawesome.com/:_authToken=YOUR-TOKEN-HERE This will allow you to download the pro solid, regular and light font packages from the fontawesome pro repo. 2. Install the FontAwesome Pro packages ( you will not be able to install them without the previous step ) npm install --save @fortawesome/pro-light-svg-icons @fortawesome/pro-regular-svg-icons @fortawesome/pro-solid-svg-icons @fortawesome/free-brands-svg-icons or yarn add @fortawesome/pro-light-svg-icons @fortawesome/pro-regular-svg-icons @fortawesome/pro-solid-svg-icons @fortawesome/free-brands-svg-icons 3. Install `react-native-svg` npm install --save react-native-svg or yarn add react-native-svg 4. Link `react-native-svg` react-native link …or if you only want to link the single library: react-native link react-native-svg **Note:** Rebuilding the app for any simulator/emulator is required after running `react-native link`. # Installation npm install react-native-fontawesome-pro --save or yarn add react-native-fontawesome-pro The postinstall script will then automatically install the pro packages for you. # Usage Configure FontAwesomePro in your main `app.js` file. Optionally set the default font from "regular" to "solid" or "light": import { configureFontAwesomePro } from "react-native-fontawesome-pro"; configureFontAwesomePro(); // configureFontAwesomePro("solid"); // configureFontAwesomePro("light"); Add icons to a component: import Icon from "react-native-fontawesome-pro"; alert("do something")} /> # Props Values for the Icon `name` prop can be found on [fontawesome.com/icons](https://fontawesome.com/icons). | prop | type | default value | | :- | :- | :- | | `name` | string | "" (If a valid `name` value is not provided, Font Awesome defaults to "question-circle") | | `color` | string, html color keyword or hexdecimal | "black" | | `size` | int | 20 | | `type` | string, one of the available Font Awesome prefix types: "regular", "solid", "light", or "brands" | "regular" | | `iconStyle` | style object | undefined | | `containerStyle` | style object | undefined | | `onPress` | function | undefined | | `activeOpacity` | number (beween 0 and 1) | 0.2 ([same as default](https://facebook.github.io/react-native/docs/touchableopacity.html#activeopacity)) | ### PR's are welcome `¯\_(ツ)_/¯` Buy Me A Coffee --- _Source: https://npm.io/package/react-native-fontawesome-pro · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._