Asset library
The asset library holds every icon and avatar you can pick in Flow. Skills, workflow nodes, workspaces, conditional formatting formulas, agents and profile pictures all draw from it, and each stores the chosen asset by name. Fontana ships a set of system assets, and anyone in your workspace can add more. Added assets are files in Fontana Files, so a Fontana Files backup includes the whole library.
Where it opens
Section titled “Where it opens”Every icon or avatar picker opens the same library, filtered to what it needs:
| Picker | Category |
|---|---|
| Skill icon, in the skill editor | Icons |
| Node icon, under Settings → Display in the node editor (Use type icon returns to the node’s type glyph) | Icons |
| Workspace icon, on the workflow Overview panel, with a colour choice | Icons |
Conditional formatting icon, named in a view’s formatting formula (setStyle("Field", "icon", "name")) |
Icons |
| Agent avatar, from the agent card header and the new-agent wizard, with the accent colour and No avatar | Avatars |
| Profile picture: Choose avatar on your profile, next to Upload | Avatars |
Click a tile to select it; icon pickers save it with Use icon. A photo you upload as your profile picture is added to the library as a shared avatar, under Shared in Avatars, so everyone in your workspace can pick it, and a Fontana Files backup restores it with the rest of the library.
Admin → Assets (/admin/assets) shows the whole library, both categories, with every management control. The page fills the admin area and the icon grid scrolls. Pickers in a smaller space, such as the new-agent wizard, keep a short grid with Expand. It needs the files:admin permission; see Roles and RBAC.
Categories and collections
Section titled “Categories and collections”The library has two categories, Icons and Avatars. Each category is split into collections, shown as tabs above a search box; All lists the whole category.
- Icons ships the built-in tile icons (Fontana), every Heroicon in Outline and Solid, and colour marks for models, providers, and apps (Models, Providers, and Apps).
- Avatars ships the Memoji, Emoji and Robot collections.
- Shared assets added at the top of a category are listed under Shared; the others sit in a named collection, for example
financeorfinance/reports. Collections nest up to three levels.
System assets are read-only. Selecting any tile shows its name, its collection and who added it.
Add an asset
Section titled “Add an asset”Choose the dashed + tile, then one of:
- Upload: drop an image or choose a file. PNG, JPEG and WebP images are cropped to a square.
- Paste SVG: paste SVG markup and preview it before saving.
- Generate icon (Icons): describe the icon; the icon agent draws variations to choose from.
- Generate avatar (Avatars): describe the avatar; the image agent draws it in the roster’s square style on a soft background, saved as a 512 px PNG.
Give the asset a name and, optionally, a collection, then save. Generation is billed like any other model call and shows in the cost center.
A shared asset’s name is how everything refers to it, for example thumbs-up. Names use lowercase letters, digits and single hyphens, up to 64 characters, and are unique across the whole library. The built-in icon names (agent, data, workflow, …) are reserved.
File types and limits
Section titled “File types and limits”| File | Kind | How it renders |
|---|---|---|
| Single-colour SVG | Tintable icon | Drawn inline in the colour of where it sits: a node’s theme, a skill tile, the icon_color a formatting formula sets |
| Multi-colour SVG | Image | Shown as an image, never recoloured |
| PNG, JPEG, WebP | Image | Shown as an image, never recoloured |
Each file is at most 5 MB, and an SVG at most 24,576 characters. The library keeps only plain drawing elements in an SVG and refuses one that uses scripts, embedded images, styles or links to other files, so an SVG asset holds a drawing and nothing else.
Rename, move and delete
Section titled “Rename, move and delete”Everyone can add assets. Only the person who added an asset, or an admin with files:admin, can rename it, move it to another collection or delete it. Only admins create, rename and delete collections; everyone else adds to the collections that exist.
Renaming or deleting an asset does not update what uses it: anything that named the old asset shows it as missing until someone picks another.
Asset references
Section titled “Asset references”SKILL.md, AGENT.md and workflow files store an asset reference in their icon field. Picking in Flow writes it for you; when you write a package by hand, use one of these forms:
| Reference | Names |
|---|---|
thumbs-up |
A shared asset in the library |
heroicons:outline/hand-thumb-up |
A Heroicon, outline or solid, by its name on heroicons.com |
lobe:Claude |
A colour model, provider, or app icon |
workflow |
A built-in tile icon |
avatar:alba |
A built-in Memoji, Emoji or Robot avatar |
Skills, workflow nodes and workspaces take icons; agents take avatars. See Skills and Author agents.