Skip to content

Conversation

@armahillo
Copy link
Contributor

@armahillo armahillo commented Oct 15, 2025

closes #46

The TLDR is that this updates our FontAwesome v4 to FontAwesomePro v6, via Runtriz. (Thanks for the assist, Alonso!)

The full methodology is detailed in Issue #46, but the short version is that I:

  1. Identify all repos we have using radius-rails
  2. Within those repos, grep for all fa-* class uses 3) Distill that down to a unique, sorted list
  3. Determine which FA sets are needed to satisfy these classes

This gave me a trivial list of files that were being used, but I suspected we could pare it down further. For each file, I reviewed whether or not the enabling class (eg. fad / fa-duotone) was being used anywhere in any of our apps that use radius-rails. Most of the collections were not being used, so I could omit them.

In the end we only had to include the basic set, fa-regular, fa-brands, and fa-solid.

I also incorporated the v4-shims fontface and styles to give us backwards compatibility - there were a couple styles (fa-empire, used on "New Order" nav link) that have been changed since v4.

The old font-awesome files have been deleted. Note that there are fewer variations now than there used to be (just WOFF2 and TTF).

Additionally, as this is significant version bump in one of the major dependencies, I did a major version bump for the gem 3.x -> 4.0.

QA Steps

  1. Clone this repo to a folder parallel to one of your radius apps
  2. Go into the Gemfile of your favorite radius-rails using app
  3. Make the radius-rails gem line look like this: gem "radius-rails", path: "../radius-rails"
  4. bundle install
  5. Reset puma
  6. Navigate around in the app, try to find places where we use glyph'd icons (nav bars and the like)

Post-Merge steps

Referring to our gem deployment docs

closes #46

The TLDR is that this updates our FontAwesome v4 to FontAwesomePro v6,
via Runtriz. (Thanks for the assist, Alonso!)

The full methodology is detailed in Issue #46, but the short version is
that I:

1) Identify all repos we have using radius-rails
2) Within those repos, grep for all fa-* class uses
3) Distill that down to a unique, sorted list
4) Determine which FA sets are needed to satisfy these classes

This gave me a trivial list of files that were being used, but I
suspected we could pare it down further. For each file, I reviewed
whether or not the enabling class (eg. fad / fa-duotone) was being used
anywhere in any of our apps that use radius-rails. Most of the
collections were _not_ being used, so I could omit them.

In the end we only had to include the basic set, fa-regular, fa-brands, and fa-solid.

I also incorporated the v4-shims fontface and styles to give us
backwards compatibility - there were a couple styles (fa-empire, used on
"New Order" nav link) that have been changed since v4.

The old font-awesome files have been deleted. Note that there are fewer
variations now than there used to be (just WOFF2 and TTF).

Additionally, as this is significant version bump in one of the major
dependencies, I did a major version bump for the gem 3.x -> 4.0.
@armahillo armahillo requested a review from a team October 15, 2025 19:11
@armahillo armahillo self-assigned this Oct 15, 2025
@armahillo armahillo requested a review from jcavena October 15, 2025 19:11
This is the most current version in the 3.x series. It corrects some
bugs and adds slightly newer versions of some dependencies:

https://github.com/twbs/bootstrap/releases/tag/v3.3.7

Additionally, I added glyphicons to the font list because it's used by
Bootstrap and didn't appear to be available previously.
@jcavena
Copy link
Contributor

jcavena commented Oct 15, 2025

It should be noted that Source Sans Pro font doesn't load on local dev and Helvetica is rendered instead,. However, this is not related to the change here. Just FYI in case you notice a different from local to staging/prod in the font rendered.

Copy link
Contributor

@jcavena jcavena left a comment

Choose a reason for hiding this comment

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

Tested locally and the glyphs looked good! We did figure out that "Source Sans Pro" is blocked locally as it's a google font and local dev defaults to Helvetica.

LGTM!

@armahillo armahillo merged commit b6d2498 into main Oct 15, 2025
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.

Upgrade font-awesome to v6+

3 participants