Gem Version Build Status

Easily store and retrieve your user's preferences and settings using NSUserDefaults.

Note that NSUserDefaults is not designed for secure data storage (passwords, tokens, etc). If you need to store data securely, use motion-keychain.


Add this line to your application's Gemfile:

gem 'motion-settings', github: 'andrewhavens/motion-settings'

And then execute:

$ bundle


Store data:

Settings.set :favorite_color, 'green'

Retrieve data:

favorite_color = Settings.get :favorite_color

Remove an individual value:

Settings.destroy :favorite_color

Remove ALL data:


Review the spec for more usage examples.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request