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.
3.3.3 - 2026-07-21
- Fixed
classandstylefailing to type-check on<FontAwesomeIcon>in JSX/TSX, a regression from #576.FontAwesomeIconis declared as aFunctionalComponent, whose JSX attribute surface resolves from the component's own props only; the declaration now also intersectsAllowedComponentPropsandVNodeProps, restoringclass,style,key, andref. Types-only and non-breaking.
- CI: the public API type-check now runs against the oldest supported Vue (3.0.x) as well as the newest, so type-only regressions that depend on a helper only newer Vue versions export are caught
- Removed the unused
npmandinstalldevDependencies. Development-only; the published package is unchanged.
3.3.2 - 2026-07-13
- New
canvasSquareandcanvasRoomyprops for the canvas sizing options introduced in Font Awesome 7.3.0
3.3.1 - 2026-07-09
- Fixed
TS2590: Expression produces a union type that is too complex to representwhen usingFontAwesomeIconin a Vue render function (h(FontAwesomeIcon, { icon })), a regression from #559. Types-only and non-breaking.
- CI: fixed the build matrix failing with
npm ERESOLVEwhen installing older Vue versions in the test matrix (a regression surfaced by #576 addingtypescriptto the lockfile), and added a strict peer-dependency check job - Documented the
test:typescommand inDEVELOPMENT.mdand added test-first and explicitdiststeps to the release checklist
3.3.0 - 2026-06-26
- Support for the new animation props introduced in Font Awesome 7.3.0:
flip360,buzz,float,jello,spinSnap,spinSnap4,spinSnap8,swing, andwag
- Improved TypeScript types for the
iconandmaskprops - Test suite updates and added testing notes to
DEVELOPMENT.md
3.2.0 - 2026-04-14
- Support for custom gradient fills
3.1.3 - 2026-01-07
- ci.yml update for node-versions
- a markdown lint fixup in CONTRIUBUTING.md
- update vitest version to 4.0.16 in
package.json
3.1.2 - 2025-09-09
-
Replaced Jest with Vitest as the test runner for unit tests. This will help improve test performance and better aligns with the Vue 3 + Vite ecosystem.
-
Updated
FontAwesomeIconProps:flipnow accepts thebooleantype in addition to'horizontal' | 'vertical' | 'both'maskIdis now correctly typed asstring
-
Updated
DEVELOPMENT.mdwith revised release instructions
3.1.1 - 2025-07-24
-
Removed version checks related to
props.fixedWidth,iconProps.title, andiconProps.title. -
The use of
requireto retrieve the version from@fortawesome/fontawesome-svg-corefor version checks has been removed to help ensure compatibility with ESM builds.
3.1.0 - 2025-07-22
-
Font Awesome Pro+ icons are now available with an active Pro+ subscription.
-
Added
widthAutoprop -
Added
rotateByprop -
Deprecated
fa-fwprop
3.0.8 - 2024-05-21
- Updated
package-lock.jsonto help fix faililng tests
3.0.7 - 2024-05-21
- Updated nodejs version in
.tool-versions - Updated Jest configuration for local testing
- Removed an unused import in
FontAwesomeLayers.test.js - Updated
node-versionsinci.yml - Added additional exports in
index.d.ts - Updated
README.mdfor new Font Awesome Doc link
3.0.6 - 2024-01-29
- Added missing exports to TS definition in
index.d.ts
3.0.5 - 2023-11-06
- Removed .tgz file
3.0.4 - 2023-11-06
- Tests for Sharp Family
- Ability to include a title prop (github issue #181)
- Prettier config file
3.0.3 - 2023-01-24
- NPM download
@fortawesome/vue-fontawesome-latestis now set to Vue 3; to download the Vue 2 package you will have to use@fortawesome/vue-fontawesome-latest-2, which is described in our Vue setup docs - CI workflow updated for testing
- README.md and package.json updated for new contributor
- Missing TypeScript animations added (github issue #428)
- Missing TypeScript sizes added (github issue #415)
3.0.2 - 2022-11-07
- Vue 3 Composition API TypeScript support (github issue #276)
- Updated README.md with a spelling correction, linter fixes, and new contributor
- Updated icon example in App.vue to use
fixed-widthrather thanfull-width
- Missing tests
3.0.1 - 2022-06-17
- README.md Documentation now points to https://fontawesome.com/docs/web/use-with/vue/
3.0.0 - 2022-06-07
- New animations for bounce and shake
- Feature to call icons using a string format
- Animations for beat, fade, beat-fade, flash, spin-pulse, and spin-reverse
- Tee-shirt sizes to include 2xs, lg, xl, and 2xl
- Flip animation when used by itself
3.0.0-5 - 2021-10-18
- Include 1.3.0-beta versions in peer dependencies
3.0.0-4 - 2021-05-23
- Fix reactivity #297
3.0.0-3 - 2020-12-09
- Allow for non-RC releases of Vue 3
3.0.0-2 - 2020-10-09
- Make Vue as an external dependency #258 #260
3.0.0-1 - 2020-09-01
- Support for Vue 3.x RC's and betas #246 #249
See the CHANGELOG prior to version 3.