Fomantic-UI Icon CLI Tool

Generate the icon.variables and icon.html.eco files for Fomantic-UI 2.9.0+

If you need this tool for FUI <= 2.8.8 or SUI, use version 1.1.0

You can use this script to generate the icons for free and pro versions of FontAwesome.

Requirements

• nodejs >=14
• npm
• or yarn

Usage

npm

$ npx create-fomantic-icons

yarn

$ yarn create fomantic-icons

Once downloaded you will be prompt with a few questions which will allow you to generate the specific icon set you want.

Select which FontAwesome icon set you want

Which icons set would you like to generate?
  > FontAwesome 5 Free
    FontAwesome 6+ Free  
    FontAwesome Pro

NOTE: You need a license to generate the icons from FontAwesome Pro

Next select which version you want to use

Which version of FontAwesome 5 Free should we download?
  > 5.8.1
    5.8.0
    5.7.2
    5.7.1
    5.7.0

Now you need to specify where to save your icons

Where would you like the dist saved? [C:\Users\Username\Documents\fui-icons]

NOTE: The default location is {pwd}/fui-icons. When you specify your own location it is relative from your current pwd. For example if I enter new-icons my icons will be placed in C:\Users\Username\Documents\new-icons.

Once you have answered all the prompts the icon set you picked will be downloaded from GitHub and will be parsed. Once it is downloaded and parsed it will build the required files for the a FUI (or SUI) theme and the docs page in the location you specified.

i asset doesn't exist locally, starting download
√ downloaded (fontawesome-free-5.8.1-web.zip)
√ asset saved (C:\Users\Username\AppData\Local\Temp\fui-icon-script\fontawesome-free-5.8.1-web.zip)
√ asset extracted (C:\Users\Username\AppData\Local\Temp\fui-icon-script\fontawesome-free-5.8.1-web)
√ icons & categories parsed

  Results:
    Solid:   936
    Outline: 151
    Thin:    0
    Brand:   426
             1513

√ build all dist files
  Files saved to C:\Users\Username\Documents\new-icons

NOTE: If the script detects you have already downloaded the icon set it will skip the download and use the local files.

Remove downloaded files

If you want to delete the downloaded files its really simple.

npm

$ npx create-fomantic-icons --clean

yarn

$ yarn create fomantic-icons --clean

Changelog

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.

[1.2.2] 2023-08-30

Fixed

• Only copy the woff/woff2 files from fontawesome package
• ignore irrelevant font files from fontawesome package
• dependency updates

[1.2.1] 2023-01-16

Added

• Support Duotone icons
• Automatically fetch deprecated icons

[1.2.0] 2022-09-29

Fomantic-UI 2.9.0+ support only. If you need this script for FUI <= 2.8.8 or SUI, use 1.1.0 instead

Changed

• Adjusted templates to generate icon.variables for new LESS mapping as of FUI 2.9.0

[1.1.0] 2022-09-28

This is the last minor version working with FUI < 2.9.0 and SUI 2.4.x

Changed

• Ability to choose between FA 5 and FA 6+ for version preselection
• Increased number of choosable versions

Fixed

• Match FUI 2.8.x
• Numbers > 9 were not converted into textual presentations
• Compilation errors

[1.0.4] 2019-07-06

Fixed

• Fixed issue in FA 5.9 causing the script to exit because the search terms where undefined (Fixes #16)

[1.0.3] 2019-05-25

Fixed

• Fixed issue with pro icon class names having numbers causing CSS errors.
• Fixed unnecessary space in file path

[1.0.2] 2019-05-09

Fixed

• Fixed issue with converter not coverting "*-v" to "vertical".

[1.0.1] - 2019-05-08

Changed

• Update icon template file description to better describe the integration between FUI and FA.

[1.0.0] - 2019-05-04

Added

• v1 CLI