Retina Rails

Makes your live easier optimizing an application for retina displays.

How it works

Retina Rails automatically generates retina versions of your uploaded images (CarrierWave or Paperclip). It detects if a visitor has a retina display and if so it displays the @2x version.

Note: It also works for images that live in assets/images.

Installation

1. Add gem 'retina_rails' to your Gemfile.
2. Run bundle install.
3. Add //= require retina to your Javascript manifest file (usually found at app/assets/javascripts/application.js).

CarrierWave

Add include RetinaRails::CarrierWave to the bottom of your uploader

class ExampleUploader < CarrierWave::Uploader::Base

  version :small do
    process :resize_to_fill => [30, 30]
    process :retina_quality => 25
  end

  include RetinaRails::CarrierWave

end

By default it sets the retina image quality to 40 which can be overriden with process :retina_quality => 25

Paperclip

Add include RetinaRails::Paperclip to the bottom of your class

class ExampleUploader < ActiveRecord::Base

  has_attached_file :image,
    :styles => {
       :original => ["800x800", :jpg],
       :big => ["125x125#", :jpg]
     },
     :retina_quality => 25

  include RetinaRails::Paperclip

end

By default it sets the retina image quality to 40 which can be overriden by adding a retina_quality option

For retina images use

image_tag('image.png', :retina => true)

Voila! Now you're using Retina Rails.

Credits

Retina Rails uses retinajs (https://github.com/imulus/retinajs)

Note on Patches/Pull Requests

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
• Send me a pull request. Bonus points for topic branches.

Copyright

Copyright (c) 2012 Johan van Zonneveld. See LICENSE for details.