Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/afomera/devise-bootstrapped

Generate Bootstrap styled views for Devise
https://github.com/afomera/devise-bootstrapped

devise devise-views rubygems

Last synced: 3 days ago
JSON representation

Generate Bootstrap styled views for Devise

Awesome Lists containing this project

README

        

# Devise Bootstrapped

This gem tries to give you a nicer place to start with your views for your Devise model when you're using Bootstrap 3.

You can find usage information below, but the gist of it is you'll run `rails g devise:views:bootstrapped` instead of the normal devise:views.

If you want to switch back to what Devise gives you no problem! Just remove the devise views folder and run the normal Devise generator command.

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'devise-bootstrapped'
```

A Bootstrap v4 version is available if you use the bootstrap4 branch from github

```ruby
gem 'devise-bootstrapped', github: 'king601/devise-bootstrapped', branch: 'bootstrap4'
```

And then execute:

$ bundle

## Usage

To use the Bootstrap views generator you'll want to have Devise and Bootstrap installed per normal installation... and once you have installed Devise and generated your user model you can copy over the views with

`rails generate devise:views:bootstrapped`

If you've already generated the Devise views you can use the -f argument to force an override but that will erase any of the changes you've made!

## Upgrading to Bootstrap v4

To upgrade to v4 you can force override the views, or you can modify each view's offsets to use the new syntax.

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/king601/devise-bootstrapped. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).