No description, website, or topics provided.
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Award flair (badges) to people using your app via the free PickFlair service (


Add this line to your application's Gemfile:

gem 'awardflair'

And then execute:

$ bundle

Or install it yourself as:

$ gem install awardflair


# Get your API keys and badges set up by:
1. Going to
2. Creating a business (which is free)
3. Getting your keys at
4. Creating some badges at

# Connect to your PickFlair account
pf =, api_secret, application_id)

# Get a list of all the badges you have created on PickFlair

# If you have already collected badges, this just gets that list again.  If you haven't, it collects them for the first time

# Get badge information using badge identifier

# Find a specific badge that you know you have created using it's name.
pf.find_badges(name: "Ruby Ace")

# Award a badge via a link that you can provide to the recipient
ruby_ace_badge = pf.find_badges("Ruby Ace").first # Choosing the first (and probably only) badge you have named "Ruby Ace"
ruby_ace_badge.award # Returns a link that you can show to recipient so they can claim the badge.  

# Award a badge by email (also gets you a link that you can give to the user.)
first_badge = pf.badges.first # Getting the first badge you created.
first_badge.award_to("", :send_email => true)

# Note that send_email is an option, not a requirement.  Default is false.  
# If you do not send an email, the user can still claim their badge by creating a PF account using that email address or by following the link you provide (which you could show to them or email to them through your own app instead of via PickFlair).
# If they have an account at PF, they are automatically awarded the badge.
# Here's an example with no email notification:
award_link = first_badge.award_to("")


  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