Hello

We want enjoyable Rails authentication

This gem is in rapid development, can be used in production by Rails experts

Share Experiences: https://gitter.im/hello-gem/hello

Status

References

Home page: https://github.com/hello-gem/hello
API Doc: https://github.com/hello-gem/hello
Version: https://github.com/hello-gem/hello
Trello Board: https://trello.com/b/WwNptyVM/hello-gem

Support

Bugs/Issues: https://github.com/hello-gem/hello/issues
Support: http://stackoverflow.com/questions/tagged/hello
Support/Chat:

Requirements and Compatibility

Ruby 1.9+
Rails 4.0+

Demo

Want to see it in action?

Visit https://bit.ly/hellogem
Sources at https://github.com/hello-gem/hello_demo

Installation

Add this line to your application's Gemfile:

gem 'hello', github: 'hello-gem/hello' # latest from github while this gem is in rapid development

And then execute:

bundle
rails g hello:install
rake db:migrate
rails g hello:views # optional

Customizing - behavior and views

These files are generated when you install this gem. They are simple to customize, just open them

+ app/
| + lib/
| | + hello/
| |   - sign_up.rb
| |   - sign_in.rb
| |   - sign_out.rb
| |   - forgot.rb
| |   - reset.rb
| + view/
|   + hello/
|       ...

Usage

TODO: review usage instructions

You only need to include our module in your User class

class User < ActiveRecord::Base
  include Hello::UserModel

  # uncomment the line below if you want username
  # validates_presence_of :username

end

We let you customize everything

class Credential < ActiveRecord::Base
  include Hello::CredentialModel

  def encrypt_password(plain_text_password)
    BCrypt::Password.create(plain_text_password)
  end

end

Thank You

Tim Lucas, John Nunemaker, Dan Everton and Johan Andersson or their open source gem user_agent_parser. As well as Tobie Langel and everybody involved in BrowserScope (full list), as our device and browser detection derives from their open-source work.

Iain Hecker for his open source gem http_accept_language that helps us understand browser's favorite locales.

Contributing

Fork it
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 new Pull Request

Versioning

Hello uses Semantic Versioning 2.0.0

gomayonqui/hello