feat: drop support for FA5, svg core 1.x

Author: charles4221

.github/workflows/ci.yml

@@ -8,17 +8,15 @@ jobs:
 
     strategy:
       matrix:
-        free-solid-svg-icons: [7.x, 6.x, 5.x]
-        fontawesome-svg-core: [7.x, 6.x, 1.2.x]
+        free-solid-svg-icons: [7.x, 6.x]
+        fontawesome-svg-core: [7.x, 6.x]
         node-version: [24.x, 22.x, 20.x]
         react: [19.x, 18.x]
         exclude:
           # For v7.x core, allow all icon versions
-          # For v6.x and v1.2.x core, exclude v7.x icons
+          # For v6.x exclude v7.x icons
           - free-solid-svg-icons: '7.x'
             fontawesome-svg-core: '6.x'
-          - free-solid-svg-icons: '7.x'
-            fontawesome-svg-core: '1.2.x'
 
     steps:
       - uses: actions/checkout@v4

CHANGELOG.md

@@ -6,12 +6,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ---
 
-## [1.0.0](https://github.com/FortAwesome/react-fontawesome/releases/tag/1.0.0) - 2025-07-29
+## [3.0.0](https://github.com/FortAwesome/react-fontawesome/releases/tag/3.0.0) - 2025-07-29
 
 ### Changed
 
 - Rewrote the entire library from plain JavaScript to TypeScript
-- Dropped support for end-of-life Node versions (below 20.x) and React versions (below 18.x)
+- Dropped support for end-of-life FontAwesome versions (below v6), Node versions (below 20.x) and React versions (below 18.x)
 - Replaced `rollup` with `tsup` for providing both ESM and CJS exports from one TypeScript source
 - Removed `prop-types` in favour of colocated typings for React component props
 - Upgraded `eslint` from v6 to v9, rewrote config as Flat Config, modernised ESLint config, plugins and rules

DEVELOPMENT.md

@@ -20,17 +20,15 @@ The following commands are available through `npm run`
 3. Update the `CHANGELOG.md`
 4. Update the `README.md` contributors section
 5. `npm run build`
-6. `npm run install.5`
+6. `npm run install.6`
 7. `npm run test`
-8. `npm run install.6`
+8. `npm run install.7`
 9. `npm run test`
-10. `npm run install.7`
-11. `npm run test`
-12. `npm publish --tag latest-0.2 --tag latest`
-13. `npm publish --tag latest-0.2 --tag latest --registry https://npm.fontawesome.com` (publish to Pro registry)
-14. `git add . && git commit -m 'Release VERSION'`
-15. `git push`
-16. Create a [new release](https://github.com/FortAwesome/react-fontawesome/releases/new) with `CHANGELOG` details
+10. `npm publish --tag latest-0.2 --tag latest`
+11. `npm publish --tag latest-0.2 --tag latest --registry https://npm.fontawesome.com` (publish to Pro registry)
+12. `git add . && git commit -m 'Release VERSION'`
+13. `git push`
+14. Create a [new release](https://github.com/FortAwesome/react-fontawesome/releases/new) with `CHANGELOG` details
 
 ## Authenticating with the npm.fontawesome.com registry
 

README.md

@@ -21,13 +21,17 @@
 
 ## 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.
+With the release of FontAwesome v7, we have marked v5 as End-of-Life. Both v6 and v7 will continue to be supported.
+
+In `react-fontawesome v3.0.0` we have also dropped support for End-of-Life versions of React and Node.js as well as IE11 browser support.
+
+If you need to use `react-fontawesome`
 
 ## Compatibility
 
 | React version | react-fontawesome version | FontAwesome Core versions | Node versions    |
 | ------------- | ------------------------- | ------------------------- | ---------------- |
-| >= 18.0.0     | 1.x.x                     | 5.x, 6.x, 7.x             | 20.x, 22.x, 24.x |
+| >= 18.0.0     | 3.x.x                     | 6.x, 7.x                  | 20.x, 22.x, 24.x |
 | >= 16.3.0     | 0.2.x                     | 5.x, 6.x, 7.x             | 18.x, 20.x       |
 | < 16.3.0      | 0.1.x                     | 5.x, 6.x                  | 14.x, 16.x       |
 

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "@fortawesome/react-fontawesome",
   "description": "Official React component for Font Awesome",
-  "version": "1.0.0",
+  "version": "3.0.0",
   "type": "module",
   "exports": {
     "types": "./dist/index.d.ts",
@@ -48,7 +48,6 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "validate-types": "tsc --noEmit",
-    "install.5": "npm --no-save install @fortawesome/[email protected] @fortawesome/[email protected]",
     "install.6": "npm --no-save install @fortawesome/[email protected] @fortawesome/[email protected]",
     "install.7": "npm --no-save install @fortawesome/[email protected] @fortawesome/[email protected]",
     "clean": "rimraf dist"
@@ -57,7 +56,7 @@
     "semver": "^7.7.2"
   },
   "peerDependencies": {
-    "@fortawesome/fontawesome-svg-core": "~1 || ~6 || ~7",
+    "@fortawesome/fontawesome-svg-core": "~6 || ~7",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {