Skip to content

docs: clarify Pro icons metadata setup (icons.json vs icon-families.json)#295

Open
kingdomseed wants to merge 1 commit intofluttercommunity:masterfrom
kingdomseed:readme-pro-icons
Open

docs: clarify Pro icons metadata setup (icons.json vs icon-families.json)#295
kingdomseed wants to merge 1 commit intofluttercommunity:masterfrom
kingdomseed:readme-pro-icons

Conversation

@kingdomseed
Copy link
Copy Markdown

@kingdomseed kingdomseed commented Feb 2, 2026

Closes #284

Clarifies the Pro icons setup documentation to resolve confusion about icons.json vs icon-families.json:

  • Separates .otf and metadata steps
  • Explains both files as alternative formats (copy/rename one, do not merge)
  • Adds Git LFS note for large metadata

…son)

- Separate .otf and metadata steps
- Explain icons.json vs icon-families.json as alternative formats
- Clarify: copy/rename one file to lib/fonts/icons.json, do not merge
- Add Git LFS note for large metadata

Closes fluttercommunity#284
Copilot AI review requested due to automatic review settings February 2, 2026 13:17
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the documentation for setting up Font Awesome Pro icons by clarifying the confusing instructions about icons.json vs icon-families.json files, directly addressing issue #284 where users were confused about whether to merge or replace these files.

Changes:

  • Separates .otf font file setup from metadata file setup into distinct steps
  • Clarifies that icons.json and icon-families.json are alternative format options (not to be merged)
  • Adds practical guidance for handling large metadata files (100+ MB) using Git LFS
  • Improves the filename space-to-dash conversion example with a concrete before/after

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: icon-families vs icons

2 participants