Splash Generator
Are you tired of spending hours creating all of the different splash image versions you need for your app?
Splash Generator effortlessly generates all of the iOS splash images you'll ever need.
Need icons? We gots them here: https://github.com/KatanaCode/motion-icon_generator
Installation
You'll need to install imagemagick first:
brew install imagemagick
Then add this line to your application's Gemfile:
gem 'motion-splash_generator'
And then execute:
$ bundle
Or install it yourself as:
$ gem install motion-splash_generator
and add it to your Rakefile
:
require 'motion/splash_generator'
Usage
Usage is super-easy:
- Create a template splash image and save it as resources/splash-template.png. This should be about 2048x2048 pixels.
- run this rake task to create your splashes
rake splashes:generate
. After a few glorious seconds you should see a new directory filled with images called simply "splashes/"
Configuration
You can also set the following environment variables to change the default behaviour:
Template image name/path
rake splashes:generate TEMPLATE="~/Desktop/my_template.png"
Target directory name
rake splashes:generate TARGET="resources" # we do this, but it's well bad!
Device types supported
rake splashes:generate DEVICES="iphone"
rake splashes:generate DEVICES="ipad"
rake splashes:generate DEVICES="universal" # creates all splash sizes
Adding extra splash sizes types.
Icons are defined in splashes.yaml. If you'd like to add your own custom splash sizes on a per-app basis, create a file named config/splashes.yaml
in your app and stick some YAML in there.
If you see an image type that we're missing, please create a pull request or an issue.
Contributing
- Fork it ( https://github.com/KatanaCode/motion-splash_generator/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Acknowledgements
This was based partly on https://github.com/spren9er/s9splashgen by @spren9er
By Katana Code: web developers, mobile app developers, nice guys