cordova-icon
Automatically resizes and copies icons for all platforms in Cordova projects.
What is cordova-icon?
cordova-icon is a Node.js command-line tool that automatically resizes and copies application icons for Cordova projects. It takes a single high-resolution icon file and generates all required platform-specific sizes for iOS, Android, Windows, and OSX, eliminating manual image processing. The tool integrates seamlessly with Cordova's build process and follows platform-specific icon requirements.
Cordova and PhoneGap developers building cross-platform mobile applications who need to manage multiple icon sizes across different operating systems. It's particularly useful for teams maintaining applications that target multiple platforms simultaneously.
Developers choose cordova-icon because it automates a tedious, error-prone part of mobile development with zero configuration for most use cases. Unlike manual resizing or platform-specific tools, it provides a unified workflow that ensures consistency across all target platforms while saving significant development time.
Overview
Automatic icon resizing for Cordova
Use Cases
Best For
- Automating icon generation for Cordova apps targeting multiple platforms
- Maintaining consistent icon quality across iOS, Android, and Windows versions
- Setting up automated build pipelines for Cordova projects
- Reducing manual image processing work in mobile development workflows
- Ensuring compliance with platform-specific icon dimension requirements
- Quickly updating app icons during redesigns or rebranding efforts
Not Ideal For
- Projects not using Cordova or similar frameworks (e.g., React Native, Flutter)
- Applications requiring dynamic icon generation based on user data or server-side logic
- Teams that prefer GUI-based asset management tools over command-line interfaces
- Developers needing automatic updates to config.xml for icon references
Pros & Cons
Pros
Automatically generates icons for iOS, Android, Windows 10, and OSX from a single source image, eliminating manual resizing as stated in the README's key features.
Supports platform-specific source images like icon-ios.png for tailored designs, providing flexibility without complex configuration.
Can be configured as a Cordova hook to run before each build, integrating into automated workflows per the README's hook setup instructions.
Works out-of-the-box with default file locations, requiring only a high-resolution icon.png in the project root for most use cases.
Cons
Requires ImageMagick to be installed separately, adding setup steps and potential compatibility issues across different operating systems.
Does not update the config.xml file, forcing developers to manually remove old icon references to avoid conflicts, as noted in the README.
Only supports iOS, Android, Windows 10, and OSX, leaving out newer or niche Cordova platforms without built-in updates.
Cannot handle dynamic or conditional icons, such as variations for different app versions or user preferences, limiting advanced use cases.
Frequently Asked Questions
Related Projects
generator-m-ionicAdvanced workflows and setup for building rock-solid Ionic apps
cordova-splashAutomatic splash screen generator for Cordova
codova-custom-configCordova/Phonegap plugin to update platform configuration files based on preferences and config-file data defined in config.xml
generator-angularjs-cordovaA yeoman generator which combines the best features and practices to initialise and scaffold an AngularJS based cordova mobile app using a module based approach.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.