fleet/tools/software/icons
Allen Houchins cecf54f2fe
Improve icon selection and resizing in generate-icons.sh (#35258)
I ran into an app that only had a single 512 x 512 png icon resulting in
the `generate-icons.sh` script failing.

```
% bash tools/software/icons/generate-icons.sh -a /Applications/logioptionsplus.app  -s "logi-options+/darwin"
Error: 128x128 icon not found.
```

This should add some additional flexibility. 

<!-- Add the related story/sub-task/bug number, like Resolves #123, or
remove if NA -->
**Related issue:** Resolves #

# Checklist for submitter

If some of the following don't apply, delete the relevant line.

- [ ] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/guides/committing-changes.md#changes-files)
for more information.

- [ ] Input data is properly validated, `SELECT *` is avoided, SQL
injection is prevented (using placeholders for values in statements)
- [ ] If paths of existing endpoints are modified without backwards
compatibility, checked the frontend/CLI for any necessary changes

## Testing

- [ ] Added/updated automated tests
- [ ] Where appropriate, [automated tests simulate multiple hosts and
test for host
isolation](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/reference/patterns-backend.md#unit-testing)
(updates to one hosts's records do not affect another)

- [ ] QA'd all new/changed functionality manually

For unreleased bug fixes in a release candidate, one of:

- [ ] Confirmed that the fix is not expected to adversely impact load
test results
- [ ] Alerted the release DRI if additional load testing is needed

## Database migrations

- [ ] Checked schema for all modified table for columns that will
auto-update timestamps during migration.
- [ ] Confirmed that updating the timestamps is acceptable, and will not
cause unwanted side effects.
- [ ] Ensured the correct collation is explicitly set for character
columns (`COLLATE utf8mb4_unicode_ci`).

## New Fleet configuration settings

- [ ] Setting(s) is/are explicitly excluded from GitOps

If you didn't check the box above, follow this checklist for
GitOps-enabled settings:

- [ ] Verified that the setting is exported via `fleetctl
generate-gitops`
- [ ] Verified the setting is documented in a separate PR to [the GitOps
documentation](https://github.com/fleetdm/fleet/blob/main/docs/Configuration/yaml-files.md#L485)
- [ ] Verified that the setting is cleared on the server if it is not
supplied in a YAML file (or that it is documented as being optional)
- [ ] Verified that any relevant UI is disabled when GitOps mode is
enabled

## fleetd/orbit/Fleet Desktop

- [ ] Verified compatibility with the latest released version of Fleet
(see [Must
rule](https://github.com/fleetdm/fleet/blob/main/docs/Contributing/workflows/fleetd-development-and-release-strategy.md))
- [ ] If the change applies to only one platform, confirmed that
`runtime.GOOS` is used as needed to isolate changes
- [ ] Verified that fleetd runs on macOS, Linux and Windows
- [ ] Verified auto-update works from the released version of component
to the new version (see [tools/tuf/test](../tools/tuf/test/README.md))
2025-11-10 15:49:52 -06:00
..
generate-icons.sh Improve icon selection and resizing in generate-icons.sh (#35258) 2025-11-10 15:49:52 -06:00
README.md Add FMA icons and icon tool (#30933) 2025-07-18 13:58:45 -06:00

Creating Icons for Fleet-maintained Apps

App icons for the Fleet server and fleetdm.com software catalog can be generated using the following script on macOS using an associated .app bundle.

Usage

bash tools/software/icons/generate-icons.sh -a /path/to/App.app -s slug-name
  • -a: Path to the .app bundle (e.g. /Applications/Safari.app)
  • -s: Slug name for the Fleet-maintained app. The portion before the slash will be used in the output filenames.

Example

bash tools/software/icons/generate-icons.sh -a /Applications/Google\ Chrome.app -s "google-chrome/darwin"

This will generate two files:

  • frontend/pages/SoftwarePage/components/icons/GoogleChrome.tsx the SVG React component
  • website/assets/images/app-icon-google-chrome-60x60@2x.png the 128x128 PNG used on the website

Notes

  • The SVG generated is embedded with a base64-encoded 32×32 version of the app's 128×128 PNG icon.
  • The TSX component name is derived from the apps name (e.g. Google Chrome.appGoogleChrome.tsx).
  • The script ensures consistent formatting and naming conventions across icon components.