Skip to content

NPM package to generate assets, like icons and/or splashscreens, for Phonegap/Cordova applications based on a master file.

License

Notifications You must be signed in to change notification settings

bcoding/cordova-assets

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cordova-assets

NPM package to generate assets, like icons and/or splashscreens, for Phonegap/Cordova applications based on a master file.

###Installation

Requires ImageMagick and its tools to be installed. They can be found here: http://www.imagemagick.org/script/binary-releases.php

sudo npm install -g cordova-assets

###Usage

**Currently only icons are supported.

Make sure that your input image for the icons is square in terms of dimensions. This makes it easier to scale. In addition, the input image should be bigger (ex: 500x500px) than any of the icon sizes since scaling down is generally better than scaling up. However, since you have fewer pixels to work with, it's inevitable that some of your detail is going to be lost. However, I'll will try and add sharpening to the images to try and minimize the loss.

Because of the awesome work of Ryan Parman (https://github.com/skyzyx/svg2png-cli) and Domenic Denicola (https://github.com/domenic/svg2png), whose code I have borrowed (OK, actually stolen), support for converting svg to png has been added.

    cga [options] input.png
options:
	-o         - Output directory. Default is current directory.
    -p         - comma delimited (no spaces) platforms to generate assets for.
                Current valid platforms are: ios android bb10 wp8 ff amazon.
                Default is all.
    -t         - Type of input image. Specify if file extension is not used for input image. Supported types are svg and png.
    			Default is png.                

###Examples cga -p ios icon.png

  • will generate all the icons for iOS using icon.png as the master file under a directory ./cga/ios/icons

cga -t svg icon

  • will generate all the icons for every supported platform using the svg input file icon as the master file

###TO-DO

  • Add support for generating splashscreens
  • Add support for sharpening, changing DPI, ...
  • Optimize and clean up code

About

NPM package to generate assets, like icons and/or splashscreens, for Phonegap/Cordova applications based on a master file.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%