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.

There are no major changes in this release. The version bump is to signal that the library is stable now and no major breaking changes are expected in the future.

• Support for Angular 19.
• All available icon packages to the ng-add schematic.
• Possibility to specify custom rotate value for fa-icon and fa-duotone-icon components.

• Angular 18.x is no longer supported. If you are using this version, please, stick with version 0.15.0.

Make sure to check upgrade instructions.

• Support for Angular 18.
• Documentation on how to use NPM Kit packages.
• Documentation on how to correctly use fa-stack in standalone components.
• Documentation on how to use custom icons.
• FAQ page with considerations on whether to use this library.
• Configuration option for the FontAwesomeTestingModule to not throw errors when adding icons.
• Documentation on how to add global styles to the page.

• Documentation for the rotate input.
• Global styles are now correctly added to the page in SSR context.

• icon input type is now more permissive.
• @fortawesome/fontawesome-svg-core became a regular dependency.

• Angular 17.x is no longer supported. If you are using this version, please, stick with version 0.14.1.
• Deprecated inputs spin and pulse. Use animation input instead.
• Deprecated inputs styles and classes.

• Removed import from @fortawesome/fontawesome-common-types, which was an undeclared dependency.

• Support for Angular 17.
• Possibility to use all components as standalone.

• Examples to use standalone components instead of modules.

• Angular 16.x is no longer supported. If you are using this version, please, stick with version 0.13.0.

• Support for Angular 16.

• Angular 15.x is no longer supported. If you are using this version, please, stick with version 0.12.1.

• Support for all animations from Font Awesome 6. See Animating icons.

Make sure to check upgrade instructions.

• Support for Angular 15.
• Documentation and option in ng-add schematic to use new Sharp Solid icons style.

• Documentation on how to create fa-icon programmatically updated to not use deprecated ComponentFactoryResolver.

• classes and styles inputs on all components are deprecated for removal as confusing and generally not useful. See upgrade instructions for the suggested migration path.

• Angular 14.x is no longer supported. If you are using this version, please, stick with version 0.11.1.

• Added a missing peer dependency on @angular/core.

• Support for Angular 14.

• Angular 13.x is no longer supported. If you are using this version, please, stick with version 0.10.2.

• position input for fa-layers-counter component.
• @fortawesome/fontawesome-svg-core@^6.1.0 as a valid peer dependency.
• Possible to pick v5 or v6 to the ng-add schematic.

• Official support for Font Awesome 6 Beta.
• Support for icon aliases introduced in Font Awesome 6 Beta.

Make sure to check upgrade instructions.

• Support for Angular 13.
• Guides on more advanced use cases.

• Approaches documentation has been improved.

• Deprecated support for the global icon library.
• Angular 12.x is no longer supported. If you are using this version, please, stick with version 0.9.0.

• Support for Angular 12.

• Angular 11.x is no longer supported. If you are using this version, please, stick with version 0.8.2.

• Crash when running ng add in Angular CLI 11.1 project. (#291)

• Support fa-layers with content wrapped into ng-container. (#283)
• Warn about missing stackItemSize on fa-icon inside fa-stack instead of silently dropping elements. (#177)

• Fixed ng add crash if tslint is not installed.

• Support for Angular 11.
• Documentation on how to use angular-fontawesome with Storybook.

• Angular 10.x is no longer supported. If you are using this version, please, stick with version 0.7.0.

• Make it possible to use fa-duotone-icon with custom duotone icons.

• Support for Angular 10.

• Angular 9.x is no longer supported. If you are using this version, please, stick with version 0.6.1.

• Fixed crash when running ng add schematic on a project using Angular 9.1 and TypeScript 3.7.

Make sure to check upgrade instructions.

• FaConfig.fixedWidth property to provide a default value for FaIcon.fixedWidth and FaLayers.fixedWidth properties.
• Documentation of a convenient approach to test components using icon library.

• Angular 8.x is no longer supported. If you are using this version, please, stick with version 0.5.0.

Make sure to check upgrade instructions.

• Support for Angular 9 and Ivy.
• FontAwesomeTestingModule to simplify testing components using icon library.
• FaConfig.fallbackIcon which allows to specify a fallback icon to use when FaIconComponent.icon is not set or specified icon definition is missing from the icon library.
• ng-add schematic to simplify initial library setup.
• Documentation on how to test components using Font Awesome icons.
• LICENSE file into the published package.

• FaConfig.globalLibrary default value has been changed to false. fa-icon/fa-duotone-icon won't look for icon definitions in the global icon library by default. See upgrade instructions for the previous release for more details about this change.
• Warning when FaIconComponent.icon is not set or specified icon definition is missing in the icon library was changed into a hard error to make it more clear and visible (in particular in the unit tests).

• FaIconComponent.iconProp was removed. Use FaIconComponent.icon instead.
• FaIconComponent.listItem was removed. Use FaIconComponent.fixedWidth + custom CSS to render icons as list markers.
• FaIconService was removed. Use FaConfig instead.

Make sure to check upgrade instructions.

• Added fa-stack component to stack two icons together:

  <fa-stack>
    <fa-icon [icon]="faCircle" stackItemSize="2x"></fa-icon>
    <fa-icon [icon]="faFlag" [inverse]="true" stackItemSize="1x"></fa-icon>
  </fa-stack>

• Added fa-duotone-icon component to work with duotone icons:

  <fa-duotone-icon [icon]="['fad', 'coffee']" primaryColor="red" secondaryColor="blue"></fa-duotone-icon>

• Added an official method to update FaIconComponent and FaDuotoneIconComponent programmatically.

• Added FaIconLibray class to replace deprecated global icon library from @fortawesome/fontawesome-svg-core package.

• Added a11yRole input for fa-icon and fa-duotone-icon components to support customizing role attribute of the rendered SVG icon.

• Added FaConfig class to globally configure angular-fontawesome.

• Added a table in README.md to document compatibility with major Angular versions.

• Added instructions on how to install library with NPM.

• Restructured documentation to make it easier to navigate and extend.
• Changed semantics of the FaIconComponent.icon property. It used to have type Icon - rendered icon object and is now changed into component input to specify icon definition with type IconProp.

• FaIconComponent.iconProp is deprecated. Use FaIconComponent.icon instead.
• Warning when FaIconComponent.icon is not set or specified icon definition is missing in the icon library is deprecated. It will throw a hard error in the next version.
• FaIconComponent.listItem is deprecated. Use FaIconComponent.fixedWidth + custom CSS to render icons as list markers.
• FaIconService is deprecated in favour of FaConfig.

• Fixed title-tooltip not being displayed in IE 11 in some cases.

• Angular 8.x is added as a valid peer dependency.
• Minor documentation updates and fixes.
• LICENSE.md file to the repository.

• Angular 6.x and Angular 7.x are no longer supported. If you are using these versions, please, stick with version 0.3.0.

• Angular 7+ is added as a valid peer dependency.

• Made it possible to set custom classes on fa-layers component.

• Added size and fixedWidth properties for fa-layers component. These can be used instead of setting fa-fw and fa-4x classes manually.

  Before:

  <span class="fa-fw fa-4x"><fa-layers>...</fa-layers></span>
  

  After:

  <fa-layers [fixedWidth]="true" size="4x">...</fa-layers>
  

• Added possibility to customize default icon prefix.

• Support for Angular 5 was removed. Now angular-fontawesome requires Angular 6+.

• Added missing peer dependencies for tsickle and tslib packages.

• Use angular-cli for building the demo app.
• Cleaned up some old configurations from previous use of angular-librarian which had been breaking the build when using 0.1.0.

• Initial stable, production-ready release of angular-fontawesome