font_awesome_flutter icon indicating copy to clipboard operation
font_awesome_flutter copied to clipboard

docs: icon-families vs icons

Open kingdomseed opened this issue 3 months ago • 2 comments

The font awesome pro icons I download include both an icons.json and an icon-families.json. The documentation for setup indicates:

Newer versions might have an icon-families.json. If this is the case, move its contents to path/to/your/font_awesome_flutter/lib/fonts/icons.json.

The intent is unclear.

This seems to indicate I should copy and paste the contents of icon-families.json into icons.json. It's not clear if that is the case or if you mean that the icon-families.json becomes the icons.json (for which a simple rename would work.) If you mean add the content of icon-families.json to icons.json, are you referring to adding it to the existing packages icons.json or to the newly downloaded icons.json (which would overwrite the one included in the font awesome flutter package.) The icon-families.json is massive--it's about 111 mb (not sure why that is with two styles and brands selected) so copying and pasting is not practical. I usually run out of memory on my M2 Max device so it would be helpful to clarify this step.

kingdomseed avatar Sep 12 '25 11:09 kingdomseed

To be completely honest, this was written in collaboration with people having access to the pro icons. I've never been able to test this out myself. Pro icon support has been added since it is close enough to the maintenance work required for the non-pro icons anyways, but we cannot provide official support.

However, if I remember correctly this was a simple rename of the icon-families.json file to icons.json. It would be great if you could let me know whether it works - then I can clarify this step in the readme!

Also: 111mb?!?! Wow.

michaelspiss avatar Oct 18 '25 09:10 michaelspiss

Hey sorry about the slow response here--I don't get many notifications from Github and then things get lost in the shuffle of life. So I went to check on what I did and see if I could remember and I believe all I did was copy over the icons.json and replace the one that is there. It's possible I also renamed the icon-families.json to icons.json one I did this the first time but when I upgraded to Font Awesome 7 I think I just copied and replaced icons.json. I'm looking it all again and it's a bit different so I'm confused. I redownloaded the kit and the icons and icon-families are small again. Sorry this isn't more helpful. I might try to redo this from the start and see what happens. Then I can post an update.

kingdomseed avatar Nov 05 '25 07:11 kingdomseed