# fortawesome/font-awesome architecture

> Architecture diagram of the GitHub repository fortawesome/font-awesome, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fortawesome/font-awesome
- Repository: https://github.com/fortawesome/font-awesome

## Overview

Font Awesome Free is an icon library and toolkit. A consumer selects an icon definition from a style or brand collection and uses the JavaScript runtime to produce or replace DOM content with SVG; the sampled runtime excerpt shows configuration, icon canonicalization, SVG conversion, and DOM scanning. The repository also contains a separate SVG-core package, free icon-definition packages, and compatibility assets. The README documents the product scope, but the sampled package runtime files are largely standalone bundles, so connections between those bundles are not inferred.

Main entry points: [`js-packages/@fortawesome/free-solid-svg-icons/faTasksAlt.js`](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTasksAlt.js) (Tasks alias), [`js-packages/@fortawesome/free-solid-svg-icons/faTasks.js`](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTasks.js) (Tasks alias), [`js-packages/@fortawesome/free-solid-svg-icons/faTachometerAltAverage.js`](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTachometerAltAverage.js) (Tachometer alias), [`js-packages/@fortawesome/free-solid-svg-icons/faTachometerAverage.js`](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTachometerAverage.js) (Simple tachometer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["SVG runtimes"]
  node_bundled_runtime["Bundled runtime<br/>[fontawesome.js]"]
  node_svg_core["SVG core<br/>[index.js]"]
  node_svg_plugins["SVG plugins<br/>[plugins.mjs]"]
  node_macro["Import macro<br/>[import.macro.js]"]
  node_common_types["Icon types<br/>[index.d.ts]"]
end

subgraph group_icons["Free icon collections"]
  node_solid_catalog["Solid icons"]
  node_regular_catalog["Regular icons"]
  node_brands_catalog["Brand icons"]
  node_bars_progress["Bars progress<br/>[faBarsProgress.js]"]
  node_gauge["Gauge<br/>[faGauge.js]"]
  node_gauge_simple["Simple gauge<br/>[faGaugeSimple.js]"]
  node_list_check["List check<br/>[faListCheck.js]"]
  node_magnifying_location["Magnifying location"]
  node_tasks_alt["Tasks alias<br/>[faTasksAlt.js]"]
  node_tasks_alias["Tasks alias<br/>[faTasks.js]"]
  node_tachometer_alias["Tachometer alias"]
  node_tachometer_simple_alias["Simple tachometer"]
  node_search_location_alias["Search location"]
end

subgraph group_compat["Compatibility assets"]
  node_brands_bundle["Brand bundle<br/>[brands.js]"]
  node_regular_bundle["Regular bundle<br/>[regular.js]"]
  node_solid_bundle["Solid bundle<br/>[solid.js]"]
  node_all_bundle["All styles<br/>[all.js]"]
  node_conflict_detection["Conflict detection"]
  node_v4_shims["Version 4 shims<br/>[v4-shims.js]"]
end

node_consumer(("Consumer"))

node_consumer -->|"uses toolkit"| node_bundled_runtime
node_tasks_alt -->|"aliases"| node_bars_progress
node_tasks_alias -->|"aliases"| node_list_check
node_tachometer_alias -->|"aliases"| node_gauge
node_tachometer_simple_alias -->|"aliases"| node_gauge_simple
node_search_location_alias -->|"aliases"| node_magnifying_location

click node_bundled_runtime "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/fontawesome.js"
click node_svg_core "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-svg-core/index.js"
click node_svg_plugins "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-svg-core/plugins.mjs"
click node_macro "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-svg-core/import.macro.js"
click node_common_types "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-common-types/index.d.ts"
click node_solid_catalog "https://github.com/fortawesome/font-awesome/tree/7.x/js-packages/%40fortawesome/free-solid-svg-icons"
click node_regular_catalog "https://github.com/fortawesome/font-awesome/tree/7.x/js-packages/%40fortawesome/free-regular-svg-icons"
click node_brands_catalog "https://github.com/fortawesome/font-awesome/tree/7.x/js-packages/%40fortawesome/free-brands-svg-icons"
click node_bars_progress "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faBarsProgress.js"
click node_gauge "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faGauge.js"
click node_gauge_simple "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faGaugeSimple.js"
click node_list_check "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faListCheck.js"
click node_magnifying_location "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faMagnifyingGlassLocation.js"
click node_tasks_alt "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTasksAlt.js"
click node_tasks_alias "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTasks.js"
click node_tachometer_alias "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTachometerAltAverage.js"
click node_tachometer_simple_alias "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTachometerAverage.js"
click node_search_location_alias "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faSearchLocation.js"
click node_brands_bundle "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/brands.js"
click node_regular_bundle "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/regular.js"
click node_solid_bundle "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/solid.js"
click node_all_bundle "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/all.js"
click node_conflict_detection "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/conflict-detection.js"
click node_v4_shims "https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/v4-shims.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bundled_runtime,node_svg_core,node_svg_plugins,node_macro,node_common_types toneBlue
class node_solid_catalog,node_regular_catalog,node_brands_catalog,node_bars_progress,node_gauge,node_gauge_simple,node_list_check,node_magnifying_location,node_tasks_alt,node_tasks_alias,node_tachometer_alias,node_tachometer_simple_alias,node_search_location_alias toneAmber
class node_brands_bundle,node_regular_bundle,node_solid_bundle,node_all_bundle,node_conflict_detection,node_v4_shims toneMint
class node_consumer toneIndigo
```

## Components

### SVG runtimes

- [Bundled runtime](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/fontawesome.js): `js-packages/@fortawesome/fontawesome-free/js/fontawesome.js`
- [SVG core](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-svg-core/index.js): `js-packages/@fortawesome/fontawesome-svg-core/index.js`
- [SVG plugins](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-svg-core/plugins.mjs): `js-packages/@fortawesome/fontawesome-svg-core/plugins.mjs`
- [Import macro](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-svg-core/import.macro.js): `js-packages/@fortawesome/fontawesome-svg-core/import.macro.js`
- [Icon types](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-common-types/index.d.ts): `js-packages/@fortawesome/fontawesome-common-types/index.d.ts`

### Free icon collections

- [Solid icons](https://github.com/fortawesome/font-awesome/tree/7.x/js-packages/%40fortawesome/free-solid-svg-icons): `js-packages/@fortawesome/free-solid-svg-icons`
- [Regular icons](https://github.com/fortawesome/font-awesome/tree/7.x/js-packages/%40fortawesome/free-regular-svg-icons): `js-packages/@fortawesome/free-regular-svg-icons`
- [Brand icons](https://github.com/fortawesome/font-awesome/tree/7.x/js-packages/%40fortawesome/free-brands-svg-icons): `js-packages/@fortawesome/free-brands-svg-icons`
- [Bars progress](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faBarsProgress.js): `js-packages/@fortawesome/free-solid-svg-icons/faBarsProgress.js`
- [Gauge](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faGauge.js): `js-packages/@fortawesome/free-solid-svg-icons/faGauge.js`
- [Simple gauge](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faGaugeSimple.js): `js-packages/@fortawesome/free-solid-svg-icons/faGaugeSimple.js`
- [List check](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faListCheck.js): `js-packages/@fortawesome/free-solid-svg-icons/faListCheck.js`
- [Magnifying location](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faMagnifyingGlassLocation.js): `js-packages/@fortawesome/free-solid-svg-icons/faMagnifyingGlassLocation.js`
- [Tasks alias](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTasksAlt.js): `js-packages/@fortawesome/free-solid-svg-icons/faTasksAlt.js`
- [Tasks alias](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTasks.js): `js-packages/@fortawesome/free-solid-svg-icons/faTasks.js`
- [Tachometer alias](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTachometerAltAverage.js): `js-packages/@fortawesome/free-solid-svg-icons/faTachometerAltAverage.js`
- [Simple tachometer](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faTachometerAverage.js): `js-packages/@fortawesome/free-solid-svg-icons/faTachometerAverage.js`
- [Search location](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/free-solid-svg-icons/faSearchLocation.js): `js-packages/@fortawesome/free-solid-svg-icons/faSearchLocation.js`

### Compatibility assets

- [Brand bundle](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/brands.js): `js-packages/@fortawesome/fontawesome-free/js/brands.js`
- [Regular bundle](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/regular.js): `js-packages/@fortawesome/fontawesome-free/js/regular.js`
- [Solid bundle](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/solid.js): `js-packages/@fortawesome/fontawesome-free/js/solid.js`
- [All styles](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/all.js): `js-packages/@fortawesome/fontawesome-free/js/all.js`
- [Conflict detection](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/conflict-detection.js): `js-packages/@fortawesome/fontawesome-free/js/conflict-detection.js`
- [Version 4 shims](https://github.com/fortawesome/font-awesome/blob/7.x/js-packages/%40fortawesome/fontawesome-free/js/v4-shims.js): `js-packages/@fortawesome/fontawesome-free/js/v4-shims.js`

### Other components

- **Consumer**

## Connections

- Consumer → Bundled runtime: uses toolkit
- Tasks alias → Bars progress: aliases (evidence: `js-packages/@fortawesome/free-solid-svg-icons/faTasksAlt.js`)
- Tasks alias → List check: aliases (evidence: `js-packages/@fortawesome/free-solid-svg-icons/faTasks.js`)
- Tachometer alias → Gauge: aliases (evidence: `js-packages/@fortawesome/free-solid-svg-icons/faTachometerAltAverage.js`)
- Simple tachometer → Simple gauge: aliases (evidence: `js-packages/@fortawesome/free-solid-svg-icons/faTachometerAverage.js`)
- Search location → Magnifying location: aliases (evidence: `js-packages/@fortawesome/free-solid-svg-icons/faSearchLocation.js`)
