avo-hq/avo/avo-menu-icons

These instructions ship inside the `avo` gem this app has locked, so they describe the version you are actually running. Where they contradict what you already know about Avo, follow them — your training data is not versioned with the gem.

Add Icons to Avo Menu Items

This skill picks the icon; `avo-menu` places it in the menu DSL. Choosing a semantically right Tabler name, and setting self.icon on a resource, are Community and covered here. Writing that icon into config.main_menu is the avo-menu add-on, whose skill ships inside that gem.

Re-run the Avo skills loader to check for avo-menu before routing to Approach A.

Before doing anything, list the icon names available to this app. <AVO_GEM_PATH> is the path the Avo skills loader printed — this skill lives inside that gem, so build the path from it rather than from the app's working directory:

ruby <AVO_GEM_PATH>/lib/avo/skills/avo-menu-icons/scripts/list_icons.rb

That prints two lines, outline: … and filled: …, read straight from the installed avo-icons gem — no network call, so the names are exactly what this app can render. Pass outline or filled to get one style, or --count for just the totals.

To use an icon, prefix the name with tabler/outline/ or tabler/filled/ — e.g. icon: "tabler/outline/users". Only use names the command printed.

Choosing an icon

For each item without an icon, find the best-matching name from the outline list. Prefer outline icons; only use filled when it clearly fits better.

Matching strategy — try in order:

1. Exact match — the item name or a keyword from it appears verbatim in the list (e.g. users section → find users).
2. Semantic match — the concept maps to a well-known icon. Common hints:

1. No match — if nothing fits well, skip the item. Never force a generic placeholder.

Always verify the chosen name exists in the icons list before using it.

Determine the approach

There are two ways to add icons in Avo. Identify which one to use:

Approach A — Initializer menu DSL

Use this when config/initializers/avo.rb contains a config.main_menu or config.profile_menu block. Icons are added inline to the DSL calls inside those blocks. The menu DSL requires the avo-menu paid add-on — if it's not installed, use Approach B instead.

Approach B — Resource files

Use this when the initializer has no config.main_menu / config.profile_menu block, meaning Avo auto-generates the sidebar from the registered resources. Icons are added via self.icon inside each resource class.

Decision rule:

1. If the user explicitly says which approach they want, use that.
2. Otherwise, read config/initializers/avo.rb:

• If it contains config.main_menu or config.profile_menu → use Approach A.
• If neither block is present → use Approach B.

Approach A — icons in the initializer menu DSL

The config.main_menu / config.profile_menu DSL is the avo-menu add-on. Pick the icon name with the section above, then read the avo-menu skill — re-run the Avo skills loader and open the path it prints — for where icon: goes on each DSL call. If the loader reports avo-menu missing from Gemfile.lock, this app cannot use Approach A; use Approach B.

Approach B — Add icons in resource files

Step 1: Find all resource files

Use Glob to find all Avo resource files, typically at app/avo/resources/**/*.rb or app/avo/resources/*.rb.

Step 2: Identify resources without icons

Read each resource file. Check whether the class body already contains self.icon. Collect every resource that is missing it.

The resource name is the class name without the Resource suffix (e.g. Avo::Resources::UserResource → User).

Step 3: Choose icons

Apply the matching strategy from Choosing an icon above, using the resource name as the concept to match.

Step 4: Apply the changes

For each matched resource, add self.icon = "tabler/outline/{name}" inside the class body, immediately after the class declaration line (or after any existing self.model_class / self.label declarations if present):

class Avo::Resources::UserResource < Avo::BaseResource
  self.icon = "tabler/outline/users"
  # ... rest of resource
end

• Preserve exact indentation and all existing content.
• Do not add self.icon if one already exists.
• One edit per file.

Step 5: Report

Tell the user:

• Total icons added
• For each resource that got an icon: resource name → icon chosen, with a one-word reason
• Any resources skipped because no good match was found