Manifesto

Drop an SVG and get every icon asset a website needs.

A Windows desktop app for generating website icons. Drop in an SVG and Manifesto creates six icon files, a web app manifest, and the four <head> tags that reference them. It also previews each icon at the size used by the target platform.

If your logo uses a single color, Manifesto can paint it for both color schemes from two colors you pick.

Website icons have a few easy-to-miss requirements.

• iOS places transparent touch icons on a black background.
• Android clips maskable icons to a circular safe zone.
• Small favicons lose detail when they are resized from a large raster image.

Manifesto handles these differences when it generates the files. Its previews use the same bytes written to disk, so they match the final output.

acme-logo/
├── favicon.ico            16 · 32 · 48, PNG-embedded
├── favicon.svg            vector; swaps on prefers-color-scheme with a second logo
├── apple-touch-icon.png   180², always opaque
├── icon-192.png           transparent, purpose "any"
├── icon-512.png           transparent, purpose "any"
├── icon-maskable-512.png  opaque, fitted to the circular Safe Zone
├── site.webmanifest       name, short_name, theme_color, background_color, icons
└── manifesto.json         the settings used, so re-dropping restores them

With two logos, one supplied or two recolored from one, you also get favicon-light.svg and favicon-dark.svg. Nothing references them. They are there for the places that do no scheme switching, such as a README badge or a social profile.

Manifesto also provides the snippet to paste into your <head>. It never reads or changes your HTML.

If your logo uses a single color and you haven't supplied a separate dark-mode file, enable Recolor this logo to create both versions. Choose a logo color and a background for either mode; the other mode swaps them.

favicon.svg switches with the visitor's light or dark mode. PNG and ICO files use the mode you select in Manifesto, with its background included to keep the logo readable.

While recoloring, enable Rounded corners for a fixed squircle background. The area outside the curve is transparent, and the logo stays intact at its existing size. This affects favicons, the two single-mode SVGs, and icon-192.png / icon-512.png. Apple-touch and maskable files stay square and opaque for the platform to shape.

Rounding starts off, including when opening older Bundles.

bun install
bun run dev

The first build downloads the Electrobun toolchain — Hutch, and the SDK it projects into .hutch/ — into a shared store outside the repo. That step needs network access; later builds do not.

Commits on main use the Conventional Commits format. Release Please maintains a release pull request containing the next version and changelog. Merging that pull request creates a draft GitHub release, builds and checks the Windows installer, attaches the files from artifacts/, and publishes the release. The initial release is 0.1.0.

Use feat: for user-facing additions and fix: for corrections. Other commit types do not normally cause a version release by themselves.

The CLI runs the same pipeline without opening the app. It uses the same defaults as the desktop interface, so both produce identical output from the same file.

bun run cli acme-logo.svg ./public
bun run cli acme-logo.svg --dark acme-dark.svg --bg '#111111'
bun run cli acme-logo.svg --recolor '#F4F6F8' --recolor-bg '#101418' --primary dark
bun run cli acme-logo.svg --recolor '#F4F6F8' --recolor-bg '#101418' --rounded
bun run cli --snippet

The CLI writes the same seven Bundle files and manifesto.json Sidecar as the app, plus the two single-scheme SVGs when a second logo exists. It does not replace existing Bundle files unless you pass --force. Other files in the output directory are left alone.

--dark <file.svg>       dark-mode logo, used on dark backgrounds and in favicon.svg
--name <string>         manifest name              (default is inferred from the filename)
--short <string>        manifest short_name        (default is inferred or uses --name)
--theme <#rrggbb>       theme_color                (default is inferred from the artwork)
--bg <#rrggbb>          icon background            (default is inferred by contrast)
--splash <#rrggbb>      manifest background_color  (default is the same as --bg)
--recolor <#rrggbb>     dark-mode color for a logo that uses one color
--recolor-bg <#rrggbb>  dark-mode background       (light mode swaps the two)
--primary <light|dark>  mode the PNG and ICO files use   (default is light)
--rounded               squircle corners (requires --recolor or --recolor-bg)
--no-optimize           skip SVGO
--force                 replace existing Bundle files in the output directory
--snippet               print the <head> snippet and exit

Defaults are inferred from rendered pixels rather than SVG markup. This works with fill="currentColor", CSS variables, symbols, and gradients.

Manifesto is feature-complete through the packaged build. Windows is the only tested platform. Electrobun supports macOS and Linux, but this project has not been tested on either one. The DPI integration is disabled outside Windows.