Icon Genie v2.0.0 is out! Major improvements!


  • Admin

    https://github.com/quasarframework/quasar/releases/tag/%40quasar%2Ficongenie-v2.0.0

    Icon Genie v2 is out! Faster, lighter and A LOT of new features. And it has been moved to the main Quasar repository. Enjoy and thoroughly read the release notes pls.

    Icon Genie v2 is out! Faster, lighter and A LOT of new features. And it has been moved to the main Quasar repository.

    What’s new in Icon Genie v2

    Icon Genie v2 is a complete rewrite from top to bottom.

    • Icon Genie is now a CLI on its own, not a Quasar App Extension any more.
    • The input files (for the icon and the background) can have any name, be placed anywhere, and they don’t need to have a fixed width + height.
    • We have refined the list of icons and splashscreens that get generated to match the latest standards and to also avoid duplication.
    • Splashscreens are created in a better manner, with the icon on top of the background (with the icon having any size ratio that you want, including 0 which means: “I only want the background image with no icon on top”)
    • New commands: generate, verify and profile, each with its own purpose.
    • The generate command now also shows you what tags you need in your /src/index.template.html file.
    • The verify command can even check if every file is in the right place and it has the right width by height.
    • A lot of new parameters: quality, svg-color, png-color, splashscreen-color, splashscreen-icon-ratio, etc etc. Check the command list page.
    • You can now control each type of asset (ico, png, splashscreen, …) for each Quasar mode individually, each with its own settings/parameters. Check the --filter, --quality and all the color parameters. One good use case is with the .ico files.
    • Automation is now possible through Icon Genie profile files.
    • You can now generate your own custom image files using the Icon Genie API through the profile files.

    Finally, we need to emphasize again on the quality parameter, which will dictate how good-looking and how big (KB) your images will be.

    Upgrading to Icon Genie v2

    This section applies to those that have been using Icon Genie v1 and are now upgrading to Icon Genie v2.

    NPM package name change

    Version 1 was a Quasar App Extension and so you installed it into your project folder. The new version (v2) does NOT need to be installed locally as it is installed globally. Your CI/CD will not need it as it is a one-time process and the output files (images) will be added directly to your project folder.

    As a consequence, please uninstall Icon Genie v1 from your project folder: $ quasar ext remove @quasar/icon-genie

    Now globally install the new Icon Genie: $ yarn global add @quasar/icongenie or $ npm install -g @quasar/icongenie

    Input files

    With version 1 you were require to have an app-icon.png and an app-splashscreen.png (at a fixed width and height). This is no longer the case with version 2. You will now just need a png file (its name can be anything) with transparency and with minimum of 64x64 px (but the higher, the better! – recommended min size: 1024x1024) for the icon, and then another optional png (any name) for the background of the splashscreens (min 128x128 px, but recommended min is 1024x1024 px).

    The splashscreens work in a completely different manner too. They will get generated with the icon on top of the optional background. The size ratio of the icon to width or height (whichever is lower) can be adjusted with the CLI params (--splashscreen-icon-ratio). You can even tell Icon Genie that the ratio is 0 so it won’t add the icon on top of the background.

    Output files

    We have refined the list of icons and splashscreens that are generated to match the latest standards and to also avoid duplication. So you will notice that some of the older files don’t get generated anymore and some are completely new. Icon Genie will now tell you what tags you need to add (if any) to your /src/index.template.html (you can copy paste the tags and replace your old ones) – so be mindful about the list of tags.

    It might be a good idea to delete all your current icon/splashscreen files and let Icon Genie do its job again. This way you will be sure that what you’re left with is actually used in your Quasar App.



    • The input files (for the icon and the background) can have any name, be placed anywhere, and they don’t need to have a fixed width + height.

    But still swears!

    $ icongenie generate -p icongenie-genprofil.json

    • Generating by profile: /home/. . . /icongenie-genprofil.json

    ⚠️ Icon source file resolution has width !== height

    $ icongenie -v
    2.0.0

    icongenie-genprofil.json
    {
    “params”: {
    “quality”: “7”,
    “include”: [“pwa”, “spa”],
    “icon”: “a1.png”,
    “background”: “a1.png”
    },
    “assets”: []
    }


  • Admin

    @ArkIv The icon file needs to be square. That’s all.


  • Admin

    Also, it makes no sense to use the same file for icon and for background. It’s equivalent to not using a background at all.



  • The icon file needs to be square. That’s all.

    and they don’t need to have a fixed width + height.

    I thought, this means that the square is not necessary …
    Well, so be it. thanks.


  • Admin

    @ArkIv improvements in Icon Genie v2.1. No longer requiring square input images 🙂 Plus many other goodies.



  • @rstoenescu Hooray! Thanks.


Log in to reply