react-native-fontawesome

Font Awesome React Native component using SVG with JS

• Documentation
• How to Help
• Contributors

Documentation

Official documentation is hosted at fontawesome.com: Check it out here

How to Help

1. Review the following docs before diving in:

2. CONTRIBUTING.md

3. CODE_OF_CONDUCT.md

4. Check the existing issues and see if you can help!

Contributors

Community:

Change Log

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

0.3.1 - 2024-05-16

Changed

• Removed defaultProps to make things compatible with React 19

0.3.0 - 2022-06-07

This release has a couple of breaking changes.

1. Minimum supported version of React Native is 0.67
2. Minimum supported react-native-svg is 11.x
3. Using width or height props are not allowed (they were deprecated in 0.2.x)
4. The secondaryOpacity will default to 40% (0.4) instead of 100% to match other Font Awesome implementations

Added

• Support for specifying icons as strings like icon="fa-solid fa-mug-empty"
• Optional testId to TypeScript .d.ts file
• Prop maskId allows Jest snapshot testing to have consistent results when using masks

Fixed

• Full support for version 6 of Font Awesome
• Using icons with masks should now be fully functional
• Duotone icons have also been fixed

0.2.7 - 2021-07-22

Changed

• Dependency updates including support for react-native 0.64 and react 17

0.2.6 - 2020-10-01

Fixed

• Removed dependence on React Native for Web's ViewPropTypes #72

0.2.5 - 2020-05-14

Added

• Support for Duotone icons #59

0.2.4 - 2020-04-27

Fixed

• Loosen peerDependencies versions to allow newer react-native and react-native-svg packages

0.2.3 - 2020-03-06

Fixed

• Support arrays in style property #28 #40 #46

0.2.2 - 2020-02-17

Fixed

• Add index.d.ts to the package.json files

0.2.1 - 2020-02-06

Fixed

• Convert 'focusable' attribute to boolean from string #42

0.2.0 - 2019-12-13

Added

• TypeScript definition file #17

Changed

• Loosened peer dependencies to prevent incorrect version warnings

0.1.0 - 2019-01-07

Changed

• Add color prop -- Delete color property on style object after resolving the fill color to avoid ambiguity -- Remove any fill="currentColor" attributes returned by fontawesome-svg-core

• Add size prop -- Deprecate height and width props

0.0.4 - 2018-10-13

Changed

• Internal clean-up, leveraging recent developments in react-native-svg

0.0.3 - 2018-10-11

Added

• Add support for masking and power transforms

0.0.2 - 2018-10-11

Added

• Add style prop with initial special-case support for setting icon color

• Re-initialize example app to allow for using it with react-native-svg 7.x

0.0.1 - 2018-10-08

Added

• Initial, minimal implementation, based on @fortawesome/react-fontawesome