Version 5.1.0

October 9, 2026

Added

  • The Icon and Icons fields are in GraphQL. Each icon is an AwesemoIcon object with its name, style, family, key, label, web-font classes, code point, SVG viewBox and path data, a complete <svg> (or just its contents), and html — the same markup {{ entry.icon }} renders, with mode, size, fixedWidth, animation, label, title and class arguments. Before this both fields came back as a bare string, so a headless front end had nothing to draw with.

Version 5.0.1

September 30, 2026

Fixed

  • The icon picker no longer empties on Craft Cloud (#1). The catalogue, path data, sprite and usage scan are now also kept in the database, and a server that is missing one restores it from there. Before this, every new container started with no catalogue: the picker said to build one, legacy names stopped resolving, SVG mode fell back to the web font and the sprite route returned 404.
  • If there is no catalogue anywhere, the first picker opened builds one instead of telling the author to go to the Icons screen.
  • The icon list, versions and render endpoints now accept control-panel requests only. Forcing a fresh version list from jsDelivr now needs the Manage the catalogue permission.

Upgrading

Run the migration. It copies whatever is in storage/awesemo/ into the database. On a host where that directory was already empty, the next build or the next picker opened fills it in.

Version 5.0.0

August 18, 2026

Initial release.

Added

  • One source of truth for the version. CDN (jsDelivr or cdnjs), a Font Awesome kit, a self-hosted package, or nothing at all when the site loads its own — chosen once, in settings.
  • An icon catalogue built from Font Awesome's own metadata, with a stylesheet-parsing fallback so kits and hand-installed packages are searchable too.
  • The Icons screen: search every icon in the installed version by name, label, search term or category, and copy the Twig, the HTML, the name or the code point.
  • Icon and Icons fields, with the same picker.
  • CKEditor and Redactor integrations that insert plain <i class="fa-solid fa-user"> markup — no shortcode, no reference tag, nothing needed at render time.
  • Three render modes: web font, inline SVG, or a <use> reference into a generated sprite, switchable site-wide from one setting.
  • |awesemoIcons, which upgrades Font Awesome markup already written in rich text to whatever the site's render mode is now.
  • Duplicate removal: other copies of Font Awesome are stripped from the response, so two versions never fight over the same class names.
  • Legacy name resolution through Font Awesome's shim data — fa fa-thumbs-o-up renders as fa-regular fa-thumbs-up instead of a blank square.
  • Custom icons: upload an SVG, use it exactly like a Font Awesome one.
  • A usage scan across templates and element content, and a subset sprite built from it.
  • A health screen covering unknown names, stale catalogues, unreachable sources, missing stylesheet subsets, duplicate copies and SVG mode without path data.
  • Console commands: awesemo/catalog/build|info|search|clear, awesemo/icons/usage|sprite, awesemo/health/check.