Adminlte Generators

AdminLTE generators provides easy AdminLTE integration with Rails 4. AdminLTE is a rich Twitter Bootstrap admin template.

Add this line to your application's Gemfile:

gem 'adminlte-generators'

Run bundle install:

bundle install

Get started:

$ rails generate adminlte:install

From now on, any time you generate a controller or scaffold, you'll get AdminLTE template. Sidebar and Header are also generated just for you.

To print the options and usage run the command rails generate adminlte:install --help

Currently only erb is supported.

Currently only scss is supported.

You could provide a name for generated layout (usefull if you've got few layouts in your app).

Simply run:

rails generate adminlte:install --layout_name=admin

AdminLTE comes with blue skin by default. If you wish to change it to black just run:

rails generate adminlte:install --skin=black

Run the generator with option --skip-turbolinks to remove turbolinks references from the generated layout.

Oh, btw you'll get 2 navigation helpers for free.

For sidebar links you could use nav_link helper:

  <%= nav_link root_path do %>
    <i class="fa fa-dashboard"></i> <span>Dashboard</span>
  <% end %>

And if you want to create a treeview, just use treeview_link helper:

  <%= treeview_link 'Lots of links here' do %>
    <%= nav_link you_shall_not_path do %>
      <i class="fa fa-angle-double-right"></i>
      One Way
    <% end %>
    <%= nav_link you_shall__path do %>
      <i class="fa fa-angle-double-right"></i>
      Another
    <% end %>
  <% end %>

There is an known issue with gem spring. In case if after running rails g adminlte:install your app will keep using default rails scaffold templates - you may need to restart spring or simply run your rails g scaffold Model or rails g controller ControllerName in another terminal window.

If someone know how to fix this - please let me know or simply create a pull request.

1. Fork it ( https://github.com/chukcha-wtf/adminlte-generators/fork )
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 a new Pull Request

• AdminLTE
• bootstrap-generators

Write tests for generators