![Icon Genie logo](https://cdn.quasar.dev/img/iconfactory.png)

# Icon Genie CLI (Global)

> A Quasar tool for generating all your Quasar App's icons and splashscreens

<img src="https://img.shields.io/npm/v/%40quasar/icongenie.svg?label=@quasar/icongenie">

[![Join the chat at https://chat.quasar.dev](https://img.shields.io/badge/chat-on%20discord-7289da.svg)](https://chat.quasar.dev)
<a href="https://forum.quasar.dev" target="_blank"><img src="https://img.shields.io/badge/community-forum-brightgreen.svg"></a>
[![https://good-labs.github.io/greater-good-affirmation/assets/images/badge.svg](https://good-labs.github.io/greater-good-affirmation/assets/images/badge.svg)](https://good-labs.github.io/greater-good-affirmation)

Please submit a PR to https://github.com/quasarframework/quasar-awesome with your website/app/Quasar tutorial/video etc. Thank you!

## What is Icon Genie

You love the default Quasar logo, probably as much as the team does, but you just spent what feels like a lifetime making your own pixel-perfect representation of the soul of your application and now you want to replace that logo with your own!

There are many different situations where your icon might be seen: in the browser tab, on the desktop, on the home screen of a mobile phone and even in an app store. Then there are splashscreens to create in all the various device sizes and orientations.

This means you need your logo in about 100+ different sizes with representative names, arcane formats, placed in the correct folders and probably some proper `<xml>` declarations for Cordova too. Even if you know exactly what you’re doing, this is a tedious and error-prone task. To make your life easy and care-free, we’ve built the Icon Genie CLI tool to make this exhausting process dead simple.

## Installation of Icon Genie

Node.js >=22.22.0 is required.

```tabs
<<| bash PNPM |>>
pnpm add -g @quasar/icongenie
<<| bash Yarn |>>
yarn global add @quasar/icongenie
<<| bash NPM |>>
npm i -g @quasar/icongenie
<<| bash Bun |>>
bun install -g @quasar/icongenie
```

## Usage

Please visit [https://quasar.dev/icongenie].

## Supporting Quasar

Quasar Framework is an MIT-licensed open source project. Its ongoing development is made possible thanks to the support by these awesome [backers](https://github.com/rstoenescu/quasar-framework/blob/dev/backers.md).

**Please read our manifest on [Why donations are important](https://quasar.dev/why-donate)**. If you'd like to become a donator, check out [Quasar Framework's Donator campaign](https://donate.quasar.dev).

## Documentation

Head on to the Quasar Framework official website: [https://quasar.dev](https://quasar.dev)

## Stay in Touch

For latest releases and announcements, follow on Twitter: [@quasarframework](https://twitter.com/quasarframework)

## Chat Support

Ask questions at the official community Discord server: [https://chat.quasar.dev](https://chat.quasar.dev)

## Community Forum

Ask questions at the official community forum: [https://forum.quasar.dev](https://forum.quasar.dev)

## Contributing

I'm excited if you want to contribute to Quasar under any form (report bugs, write a plugin, fix an issue, write a new feature). Please read the [Contributing Guide](../CONTRIBUTING.md).

## Semver

Quasar is following [Semantic Versioning 2.0](https://semver.org/).

## License

Copyright (c) 2018-present Razvan Stoenescu

[MIT License](http://en.wikipedia.org/wiki/MIT_License)
