Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@fortawesome/react-fontawesome

FortAwesome6.2mMIT0.2.3TypeScript support: included

Official React component for Font Awesome

readme

Official Javascript Component

react-fontawesome

npm

Font Awesome React component using SVG with JS

Documentation

react-fontawesome now supports forwardRef for version 0.2.x or above. This was a breaking change so if you are using React older than version 16.3.0 choose the 0.1.x version of this component.

Compatibility

React version react-fontawesome version
< 16.3.0 0.1.x
>= 16.3.0 0.2.x

Official documentation is hosted at fontawesome.com:

Check it out here

How to Help

Review the following docs before diving in:

And then:

  1. Check the existing issue and see if you can help!

Contributors

The following contributors have either helped to start this project, have contributed code, are actively maintaining it (including documentation), or in other ways being awesome contributors to this project. We'd like to take a moment to recognize them.

Name GitHub
Nate Radebaugh @NateRadebaugh
Kirk Ross @kirkbross
Prateek Goel @prateekgoel
Naor Torgeman @naortor
Matthew Hand @mmhand123
calvinf @calvinf
Bill Parrott @chimericdream
Mike Lynch @baelec
Lukáš Rod @rodlukas
Proudust @proudust
Tiago Sousa @TiagoPortfolio
Alexey Victorov @AliMamed
Calum Smith @cpmsmith
squiaios @squiaios
WyvernDrexx @WyvernDrexx
Font Awesome Team @FortAwesome

If we've missed someone (which is quite likely) submit a Pull Request to us and we'll get it resolved.

Releasing this project (only project owners can do this)

See DEVELOPMENT.md

changelog

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.2.3 - 2025-07-23

Changed

  • Font Awesome Pro+ icons are now available with an active Pro+ subscription.

  • Removed example directory and files

  • Deprecated fa-fw prop

Added

  • Added widthAuto prop

  • Added rotateBy prop


0.2.2 - 2024-05-22

Fixed

  • Props with nullable/undefined values no longer throw an error #562 #560

0.2.1 - 2024-05-16

Changed

  • Remove defaultProps to be compatible with React 19

0.2.0 - 2022-06-29

Added

  • Support for React forwardRef if using React >= 16.3

Previous 0.1.x change log available here