image-res-generator
Introduction
Automatic icon and splash screen resizing CLI tool for Cordova/Ionic/PhoneGap based applications and PWAs.
It automatically resizes and copies your icon.png
and splash.png
files to the platform dedicated directories.
It does NOT require any external binary libraries. Javascript only.
Usage
Required files
Add your icon.png
(1024x1024 px) and splash.png
(2732x2732 px) files to the 'resources' folder under the root of your cordova based project.
Command line
$ image-res-generator
or
$ irgen
ATTENTION: while preserving source files, it overwrites previous output if any.
Options
-V, --version output the version number
-i, --icon [optional] optional icon file path
(default: ./resources/icon.png)
-s, --splash [optional] optional splash file path
(default: ./resources/splash.png)
-p, --platforms [optional] optional platform token comma separated list
available tokens: android, ios, windows, blackberry10, pwa
(default: all platforms processed)
-o, --outputdir [optional] optional output directory
(default: ./resources/)
-I, --makeicon [optional] option to process icon files only
-S, --makesplash [optional] option to process splash files only
-h, --help output usage information
Do yourself a favour
Add to your package.json a script definition to match your file generation needs. This way, you won't have to repeat the whole command along with the options.
An example
{
...
"scripts": {
...
"resgen": "irgen -p android,ios"
}
}
All you have to do then is type :
npm run resgen
NPM will cope with typing the whole command line for you.
Platforms
Supported platforms:
- iOS
- icons
- splash screens
- Android
- icons
- splash screens
- Windows
- icons
- splash screens
- Blackberry 10
- icons
- PWAs
- icons
Contributing
Thanks for your interest in contributing! Read up on our guidelines to start contributing.
Credits
This open-source project is made possible with the help and support of the amazing open source community. Special thanks to:
- All contributors in this project ✨💚.
- @olivab for creating and maintaining the original project cordova-res-generator.
- Contributors to cordova-res-generator.
License
This project is made available under the terms of the GPLv3. See the LICENSE file for the full text of the license.