Version 5.1.0
October 9, 2026
Added
- The Icon and Icons fields are in GraphQL. Each icon is an
AwesemoIconobject with its name, style, family, key, label, web-font classes, code point, SVG viewBox and path data, a complete<svg>(or just its contents), andhtml— the same markup{{ entry.icon }}renders, withmode,size,fixedWidth,animation,label,titleandclassarguments. 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-uprenders asfa-regular fa-thumbs-upinstead 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.