Alternative icons

By default, Discourse bundles icons from the excellent FontAwesome library. But there are a lot of free-to-use icon libraries out there. This topic is the home of alternative icon sets. It lists some theme components that you can try now, but it also describes how you can contribute to have Discourse support other icon sets.

Alternative icon sets

If you are interested in trying out a different icon set, here is a list of theme components that you can try out:

(See How to install a theme or theme component for help getting one of these repos in your Discourse site.)

These components are a work in progress. You can use them, but note that not every single icon from core will have an appropriate replacement. (Contributions are welcome, though, see below.)

Some screenshots:

Feather icons (using the WCAG Dark color scheme)


Heroicons (using the WCAG Light color scheme)


Unicons (using the Grey Amber color scheme)


Phosphor Duotone (using the WCAG Light color scheme)

Contributing

Theme developers and designers, this section is for you.

The components listed above are generated using the discourse-alt-icons utility repository, which streamlines replacing icons in Discourse core with icons from other open source icon sets. The heart of the repository is a build script that generates a theme component from a JSON file of icon name mappings.

Contributions are welcome and encouraged. Discourse uses many icons from FontAwesome and finding matches from other icon sets is a fun task, but it is time-consuming. If you want to help, you can pull the discourse-alt-icons and follow the steps in the readme to add matches for icons that don’t yet have them.

Supporting other icon sets

Please use the replies below to propose adding support for another icon set. Or, even better, with a little bit of work you can send a pull request to the discourse-alt-icons repository. Note, that only icon sets with very permissive licenses (i.e. must allow modification, distribution, private use) will be considered.


This document is version controlled - suggest changes on github.

30 Likes

If anyone is looking to contribute an icon set, but doesn’t have one in mind:

MIT licensed, designed by the folks over at tailwindlabs.com

4 Likes

Hope to help, here are some icons you can use

Nice suggestion, I added this and updated the OP with a screenshot. It doesn’t have a lot of icons, for example, it has no icons for the composer toolbar, but the icons it does have are quite nice. Thanks!

2 Likes

Does this mean that Google Fonts is out of the question?

Google’s Material Icons license is permissive enough. But their repo is gigantic, and it might be time-consuming to find the path to each icon.

1 Like

Yes, but once it’s done, you won’t have to do it again. :slight_smile:

1 Like

By any change, could we get the Phosphor Regular Icons as well?

2 Likes

With a little bit of work, you (or anybody really), should be able to make a Phosphorus Regular repo from the duotone one. I’m happy to review and include it in the list here if we have a repo.

2 Likes

That would be amazing. We should have by default a list of Icon Sets in /admin, since FontAwesome are kinda ugly. :ok_man:

Uglyness is matter of taste. But nowadays serving of free icons by Font Awesome is really limited.

On other side — how many really looks icons :joy:

It seems that when we load one of those sets, the missing icons aren’t replaced by the default Font Awesome ones, so it’s just blank, not very usable… :thinking:

I like the feather set, but it lacks many useful icons.

I’ve made a PR on the repo. Some changes are far from perfect, but a bad icon is still better than no icon at all :smiling_face_with_tear:

Here are all the newly added icons (badly vibe-coded page, outdated “alternatives” column)
https://canapin.dev/discourse/feather-icons/

Main and not-so-good changes:

image
Credit card is the closest to address-card in term of shapes. Other alternatives could be a closed or open book…

image
The best is crosshair, I think. A simple pen has a fairly similar shape, but it’s a pen, and also already used for edits.

image
Nothing close. In my opinion, the best fit is the CPU icon. I messed up in my PR and used the Zap icon so I’ll send another PR to address this.

1 Like

I just noticed Lucide icons:

This is a fork of Feather, which is up-to-date. Feather has only 287 icons, Lucide has 1701 (and they have, of course, most if not all the missing icons).

Both sets are under MIT licence.

So I guess in this case support for Feather should be dropped, and replaced by Lucide.

My pull request seems a bit meaningless now :lolsob:

Perhaps I can try creating a repo for this set, if approved by the team…

2 Likes

Irrelevant, but when going to https://canapin.dev, scrolling to the bottom and clicking on Virtualmin’s forum, it was Discourse :discourse: !

1 Like