rails_material_admin 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f1478109456a5e1c1d47dcf76c6c71afa8506ec6fdbf6baadd2bf38666ef7788
+  data.tar.gz: d840026d251d8f5289ed6269a489be0a1e22c7f49c8a3484499ffc99f70eda3a
+SHA512:
+  metadata.gz: 706bf3b12fbdbec496edfd5fb383ef8811d0073910544234fd9dbeb102ed6b6254bf9f6677be710ca1c7196d32b6561be25630c078cfba78a1b5d29cb3147428
+  data.tar.gz: c029ddd8d127f7d336e5ff66ce8381b43257cf31a9b89324394508abd1cd7cb7faba1d06972df88a73a7cc78e30ee58867237a0db370b6480808249f9970ed62

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2020 Tracy Cai
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,65 @@
+# MaterialAdmin
+Short description and motivation.
+
+## Prerequisite
+### Set up your db first
+
+### packsge.json
+```json
+{
+  "name": "beebeego-back",
+  "private": true,
+  "dependencies": {
+    "@rails/webpacker": "5.1.1",
+    "core-js": "3",
+    "file-loader": "^6.0.0",
+    "url-loader": "^4.1.0",
+    "expose-loader": "^0.7.5",
+    "resolve-url-loader": "^3.1.1",
+    "jquery": "^3.5.1",
+    "select2": "^4.0.13",
+    "popper.js": "^1.16.1",
+    "rails-ujs": "^5.2.4-2",
+    "stimulus": "^1.1.1",
+    "turbolinks": "^5.2.0",
+    "datatables.net-bs4": "^1.10.21",
+    "datatables.net-responsive-bs4": "^2.2.5"
+  },
+  "devDependencies": {
+    "webpack-dev-server": "^3.11.0"
+  }
+}
+```
+
+
+## Usage
+How to use my plugin.
+
+### Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'material_admin'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+### Init an admin template
+```
+rails generate material_admin [layout_name]
+```
+
+### Init a simple users CRUD template
+```
+rails generate crud user --options layout_name:[layout_name]
+```
+
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,27 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'MaterialAdmin'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/app/controllers/concerns/datatable_decorator.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module DatatableDecorator
+  extend ActiveSupport::Concern
+
+  def decode_datatable_params
+    row_start = params['start'].to_i
+    rows_per_page = params['length'].to_i
+    search_text = params['search']['value']
+
+    # Convert hashed arrays into array
+    columns = []
+    params['columns'].each do |k, v|
+      if v['data'].is_a? ActionController::Parameters
+        v['data'].each do |kk, vv|
+          v['name'] = v['data']['_'] if v['name'].blank?
+          v[kk] = vv
+        end
+      else
+        v['name'] = v['data'] if v['name'].blank?
+      end
+      columns[k.to_i] = v
+    end
+
+    order_columns = []
+    include_columns = []
+    order_expressions = []
+    params['order'].each do |k, v|
+      col = columns[v['column'].to_i]
+      sort_params = col['sort']
+
+      if sort_params.present?
+        if sort_params.is_a? ActionController::Parameters
+          order_expressions << "#{sort_params['model'].pluralize}.#{sort_params['column']} #{v['dir']}"
+          include_columns << sort_params['model'].pluralize
+        else
+          order_expressions << "#{sort_params} #{v['dir']}"
+        end
+      else
+        order_expressions << "#{col['name']} #{v['dir']}"
+      end
+      order_columns[k.to_i] = v
+    end
+
+    # Now let's rock it and do the processing
+    {
+      per_page: rows_per_page,
+      page: row_start / rows_per_page + 1,
+      columns: columns,
+      order_columns: order_columns,
+      sort_statement: order_expressions.join(','),
+      search_text: search_text,
+      include_columns: include_columns
+    }
+  end
+
+  # 用JSON做一个表示操作成功的Response
+  #
+  # == Parameters:
+  # options:: 选项
+  #
+  # == Options:
+  # 在缺省情况下，调用这个函数给一个空的hash也可以，我会自动给回200为response code，错误信息和对象都为空，但是如果需要的，也可以传入一个带哈希作为选项，主要支持：
+  # msg:: 需要显示的信息，缺省为空字符串
+  # template:: 需要使用的JSON模板，缺省为common/api
+  #
+  def json_success_response(options = {})
+    template = options.delete(:template) || 'common/api'
+    msg = options.delete(:msg) || ''
+    @code = 200
+    @message = msg
+    @errors = nil
+    render template, layout: 'json_with_meta'
+  end
+
+  # 用JSON做一个表示操作失败的Response
+  #
+  # == Parameters:
+  # msg:: 需要显示的错误信息
+  # errors:: 错误对象
+  def json_failed_response(msg, errors = nil, template = nil)
+    @code = 500
+    @message = msg
+    @errors = errors
+    template ||= 'common/api'
+    render template, layout: 'json_with_meta', status: 400
+  end
+
+  def response_after_save_json(result, obj)
+    if result
+      json_success_response
+    else
+      json_failed_response(view_context.tv('message_save_failed_with_msg', msg: obj.errors.full_messages), obj.errors)
+    end
+  end
+end

data/app/helpers/admin_helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module ApplicationHelper
+  def body_id
+    ctrl_name = controller_path.gsub(%r{^v\d+/}, '').tr('/', '-')
+    [ctrl_name, action_name].map(&:dasherize).join('-')
+  end
+
+  def body_class
+    controller_path.gsub(%r{^v\d+/}, '').tr('/', '-').dasherize
+  end
+
+  def body_data_controller
+    @body_data_controller ||= controller_name.tr('_', '-').split('/').join('-')
+  end
+
+  def sort_opt(model, column)
+    { model: model, column: column }.to_json
+  end
+end

data/app/helpers/datatables_helper.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+module DatatablesHelper
+  # Generate a html table tag for supporting ajax datatables
+  #
+  # == Parameters:
+  #
+  # options::
+  #   Options which will be simply passed to content_tag method
+  #
+  # block::
+  #   Content for thead, which is required for ajax datatable
+  #
+  # == Usage:
+  #
+  #    <%= dt id: 'entities-list', class: 'display', :'data-url' => info_articles_path(:format => :json),
+  #        :'data-sorting_column' => (if current_sys.selfdrive? then 4 else 5 end), :'data-sorting_dir' => 'desc' do %>
+  #    <%= dt_col(data: { m_data_prop: 'id', s_type: 'numeric', s_width: '50px' }){ InfoArticle.human_attribute_name :id } %>
+  #    ...
+  #    <%= dt_col(data: { m_data_prop: 'actions', s_width: '70px', b_sortable: 'false' }) { t 'actions' } %>
+  #  <% end %>
+  #
+  def datatable_tag(options)
+    # User autoWidth to calculate width, and use scrollX to allow scroll table, it will cause some black on the right of table, so need to set 100% width
+    # Pass in options params to add additional configs
+    content_tag :table, { width: '100%' }.merge(options) do
+      html = content_tag(:thead) { yield } || ''
+      html << content_tag(:tbody)
+      raw html
+    end
+  end
+  alias dt datatable_tag
+
+  # Similiar to @datatable_tag method but this will pass section as the block parameter,
+  # means in the block, we have to render sections accordingly.
+  # We support :thead, :tbody and :tfoot right now
+  def datatable_tag_section(options)
+    content_tag :table, options do
+      html = content_tag(:thead) { yield(:thead) } || ''
+      html << content_tag(:tbody) { yield(:tbody) }
+      html << content_tag(:tfoot) do
+        content_tag(:tr) { yield(:tfoot) }
+      end
+      raw html
+    end
+  end
+  alias dts datatable_tag_section
+
+  # Generate th html tag for building up ajax datatable html tag
+  #
+  # == Parameters:
+  #
+  # options::
+  #   Options which will be passed to content_tag method. To be awared, an node named "data" will be treated as
+  #   an hash, and it will be used to build HTML options with pattern like "data-*"
+  #
+  # == Usage:
+  #   To render a datatable column with data property id:
+  #     dt_col(data: { m_data_prop: 'id', s_type: 'numeric', s_width: '50px' }){ InfoArticle.human_attribute_name :id }
+  #   This will render:
+  #     <th data-m_data_prop="id" data-s_type="numeric" data-s_width="50px">编号</th>
+  #
+  #   To render a datatable column with data property actions, with sorting feature disabled:
+  #     dt_col(data: { m_data_prop: 'actions', s_width: '70px', b_sortable: 'false' }) { t 'actions' }
+  #   This will render:
+  #     <th data-b_sortable="0" data-m_data_prop="actions" data-s_width="70px">操作</th>
+  #
+  def datatable_col_tag(name = nil, options = {})
+    options = name if block_given?
+    data_options = options.delete :data
+    # Build up data options
+    data = {}
+    data_options.each { |k, v| data["data-#{k}"] = v } if data
+    if block_given?
+      content_tag(:th, options.merge(data)) { yield }
+    else
+      content_tag(:th, name, options.merge(data))
+    end
+  end
+  alias dt_col datatable_col_tag
+
+  # Shortcut method for datatable_col_tag for those columns with needs for only data attributes
+  #
+  # == Parameters:
+  # col_title::
+  #   Column title
+  # data_options::
+  #   Hash represent data attributes
+  #
+  # == Usage:
+  #   <%= d_col InfoArticle.human_attribute_name(:info_column_id ), m_data_prop: 'info_column_name', s_width: '60px' %>
+  def datatable_col_tag_dataonly(col_title, data_options)
+    datatable_col_tag(data: data_options) { col_title }
+  end
+  alias d_col datatable_col_tag_dataonly
+
+  # A short function to wrap actions group for table rows with edit, delete buttons and others.
+  #
+  # == Parameters:
+  # edit_target::
+  #   Link target for editing
+  # del_target::
+  #   Link target for deleting
+  # other_target::
+  #   Link targets for other actions
+  # opts::
+  #   Options to be passed to the buttons, :edit for edit button and :del for delete button as well as others
+  #
+  # == Usage:
+  #   edit_and_del(edit_route_path(row), route_path(row), [], {edit: {data:{id: 1}, class: ''}, del: {data:{id: 1}, class: ''}})
+  #
+  def render_edit_and_del_actions(edit_target, del_target, other_actions = [], opts = {})
+    actions = [{
+      target: edit_target,
+      link_text: '编辑',
+      options: opts.delete(:edit)
+    },
+               {
+                 target: del_target,
+                 link_text: '删除',
+                 options: { method: :delete }.merge(opts.delete(:delete))
+               }]
+
+    if other_actions.any?
+      other_actions.each do |action|
+        key = action.keys.first
+        actions << {
+          target: action[key][:target],
+          link_text: action[key][:link_text],
+          options: { method: action[key][:method] }.merge(opts.delete(key))
+        }
+      end
+    end
+
+    row_actions actions
+  end
+  alias edit_and_del render_edit_and_del_actions
+
+  # Generate HTML codes for array of buttons for each row in a html grid.
+  #
+  # == Parameters:
+  # buttons::
+  #   An array contains buttons information to be included in HTML table row, which normally will be the last col.
+  #   Ruby link_to function will be used for each button in the array, each button of the array will be an hash,
+  #   it should contained following information:
+  #     :target: Link target
+  #     :link_text: Text to include between begin and end tag of an A ancor
+  #     :button_style: Button style class, if this has been indicated, this function won't apply it's default class
+  #     :options: Extra options to be assigned to the link_to function, except the :class key, it will be combinted
+  #             with some default css classes
+  # == Returns:
+  # HTML codes to be inserted into html table row cell, to present actions in each table row.
+  #
+  # == Usage:
+  #   row_actions [
+  #      { target: edit_route_path(row), link_text: icon(:edit), options: data {data: id} },
+  #      {
+  #        target: route_path(row, :format => :json), link_text: icon(:'trash-o'), button_style: :'btn-danger',
+  #        options: { :remote => true, :method => :delete, :data => { :confirm => tv('delete_row_confirm') } }
+  #      }
+  #    ]
+  #
+  def render_table_row_actions(buttons)
+    actions = "<div class='row-actions'>".dup
+    buttons.each do |b|
+      b[:options] ||= {}
+      actions << link_to(raw(b[:link_text]), b[:target], b[:options])
+    end
+    actions << '</li></ul></div>'
+  end
+  alias row_actions render_table_row_actions
+
+  def render_multi_values(items)
+    actions = '<span>'.dup
+    items.each do |item|
+      actions << "#{item || '/'}<br>"
+    end
+    actions.chomp('<br>') << '</span>'
+  end
+  alias multi_values render_multi_values
+
+  # Helper to be used in jbuilder for rendering datatable json response
+  #
+  # == Usages:
+  #     datatable_json_response do
+  #       json.foo 'bar'
+  #     end
+  #
+  # @return Datatable json response
+  def datatable_json_response(json, &block)
+    json.draw params['draw'] || 0
+    json.recordsTotal @total_rows if @total_rows
+    json.recordsFiltered @total_rows_filtered || @total_rows if @total_rows || @total_rows
+    if defined?(@error)
+      json.error @error
+    else
+      json.data(&block)
+    end
+  end
+
+  def sort_opt(model, column)
+    { model: model, column: column }.to_json
+  end
+end

data/app/views/admin/sessions/new.html.slim

@@ -0,0 +1,30 @@
+section#wrapper
+  .login-register
+    .login-box.card
+      .card-body
+        = form_for resource,
+          as: resource_name,
+          url: session_path(resource_name),
+          html: { class: 'form-horizontal form-material' } do |f|
+
+          h3.box-title.m-b-20 Sign In
+
+          .form-group
+            .col-xs-12
+              = f.email_field :email, autofocus: true, autocomplete: "email", class: 'form-control'
+
+          .form-group
+            .col-xs-12
+              = f.password_field :password, autocomplete: "current-password", class: 'form-control'
+
+          - if devise_mapping.rememberable?
+            .form-group
+              .d-flex.no-block.align-items-center
+                .checkbox.checkbox-primary.p-t-0
+                  = f.check_box :remember_me
+                  = f.label :remember_me
+
+          .form-group.text-center.m-t-20
+            .col-xs-12
+              = f.submit "Log in", class: 'btn btn-info btn-lg btn-block text-uppercase waves-effect waves-light'
+

data/app/views/layouts/admin.html.slim

@@ -0,0 +1,33 @@
+doctype html
+html xmlns:wb="http://open.weibo.com/wb"
+  head
+    title
+      | Admin Panel
+    meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no"
+    = csp_meta_tag
+    = csrf_meta_tags
+    = javascript_pack_tag 'admin', 'data-turbolinks-track': 'reload'
+    = stylesheet_pack_tag 'admin_style', media: 'all', 'data-turbolinks-track': 'reload'
+
+  body[
+    id=body_id
+    class="fix-header fix-sidebar card-no-border #{body_class}"
+    data-controller=body_data_controller
+  ]
+    /! Preloader - style you can find in spinners.css
+    // NOTE: Need fix for turbolinks.
+    / .preloader
+    /   svg.circular viewbox=("25 25 50 50") 
+    /     circle.path cx="50" cy="50" fill="none" r="20" stroke-miterlimit="10" stroke-width="2" /
+
+    /! Main wrapper - style you can find in pages.scss
+    #main-wrapper
+      = render 'admin/shared/header'
+      = render 'admin/shared/sidebar'
+      
+      .page-wrapper
+        .container-fluid
+          = yield :breadcrumb
+          .row
+            = yield
+

data/app/views/layouts/unauthorized.html.slim

@@ -0,0 +1,13 @@
+doctype html
+html
+  head
+    meta content=("text/html; charset=UTF-8") http-equiv="Content-Type" /
+    title
+      | Admin Panel
+    = csrf_meta_tags
+    = csp_meta_tag
+    = stylesheet_pack_tag 'admin_style', media: 'all', 'data-turbolinks-track': 'reload'
+    = javascript_pack_tag 'admin', 'data-turbolinks-track': 'reload'
+
+  body
+    = yield

data/app/views/shared/_breadcrumb.html.slim

@@ -0,0 +1,22 @@
+- title   = local_assigns[:title] ? title : []
+- links   = local_assigns[:links] ? links : []
+- buttons = local_assigns[:buttons] ? buttons : []
+- data_options = local_assigns[:data_options] ? options : {}
+
+.row.page-titles
+  .col-md-6.col-8.align-self-center
+    h3.text-themecolor.m-b-0.m-t-0 = title
+    ol.breadcrumb
+      - links.each do |ele|
+        li.breadcrumb-item
+          - if ele[:link]
+            = link_to ele[:text], ele[:link]
+          - else
+            span = ele[:text]
+
+  .col-md-6.col-4.align-self-center.text-right
+    - buttons.each do |btn|
+      = link_to btn[:link], id: btn[:id], class: btn[:class], data: btn[:data_options] do
+        - if btn[:icon]
+          i class="fa fa-#{btn[:icon]}"
+        span.ml5 = btn[:text]

data/app/views/shared/_error_messages.html.slim

@@ -0,0 +1,8 @@
+- if resource.errors.any?
+  #error_explanation
+    h2
+      = I18n.t("errors.messages.not_saved", count: resource.errors.count, resource: resource.class.model_name.human.downcase)
+    ul
+      - resource.errors.full_messages.each do |message|
+        li
+          = message

data/app/views/shared/_header.html.slim

@@ -0,0 +1,24 @@
+/! Topbar header - style you can find in pages.scss
+header.topbar
+  nav.navbar.top-navbar.navbar-expand-md.navbar-light
+    /! Logo
+    .navbar-header
+      a.navbar-brand href="/" tppabs="https://wrappixel.com/demos/admin-templates/material-pro/material/index.html" 
+        /! Logo icon
+        b
+          /! You can put here icon as well // <i class="wi wi-sunset"></i> //
+          /! Dark Logo icon
+          / img.dark-logo alt="homepage" src="../assets/images/logo-icon.png" /
+          /! Light Logo icon
+          / img.light-logo alt="homepage" src="../assets/images/logo-light-icon.png" /
+          / = image_tag nil, width: 45, class: 'light-logo'
+        span.inline-block.ml10 Logo
+    .navbar-collapse
+      ul.navbar-nav.mr-auto.mt-md-0
+        li.nav-item
+          a.nav-link.nav-toggler.hidden-md-up.text-muted.waves-effect.waves-dark href="javascript:void(0)" 
+            i.mdi.mdi-menu
+        li.nav-item
+          a.nav-link.sidebartoggler.hidden-sm-down.text-muted.waves-effect.waves-dark href="javascript:void(0)" 
+            i.ti-menu
+

data/app/views/shared/_links.html.slim

@@ -0,0 +1,19 @@
+- if controller_name != 'sessions'
+  = link_to "Log in", new_session_path(resource_name)
+  br
+- if devise_mapping.registerable? && controller_name != 'registrations'
+  = link_to "Sign up", new_registration_path(resource_name)
+  br
+- if devise_mapping.recoverable? && controller_name != 'passwords' && controller_name != 'registrations'
+  = link_to "Forgot your password?", new_password_path(resource_name)
+  br
+- if devise_mapping.confirmable? && controller_name != 'confirmations'
+  = link_to "Didn't receive confirmation instructions?", new_confirmation_path(resource_name)
+  br
+- if devise_mapping.lockable? && resource_class.unlock_strategy_enabled?(:email) && controller_name != 'unlocks'
+  = link_to "Didn't receive unlock instructions?", new_unlock_path(resource_name)
+  br
+- if devise_mapping.omniauthable?
+  - resource_class.omniauth_providers.each do |provider|
+    = link_to "Sign in with #{OmniAuth::Utils.camelize(provider)}", omniauth_authorize_path(resource_name, provider)
+    br

data/app/views/shared/_radio_box.html.slim

@@ -0,0 +1,17 @@
+/* Required parameters:
+ *   name: ''
+ *   radios: [{ id: '', value: '', text: '' }]
+ */
+
+- name = local_assigns[:name] ? name : ''
+- radios = local_assigns[:radios] ? radios : []
+
+- radios.each_with_index do |radio, i|
+  = radio_button_tag name,
+    radio[:value],
+    radio[:checked],
+    class: 'radio-col-cyan',
+    id: radio[:id],
+    disabled: radio[:disabled],
+    data: radio[:opts]
+  label for=radio[:id] = radio[:text]

data/app/views/shared/_sidebar.html.slim

@@ -0,0 +1,23 @@
+/! ==============================================================
+/! Left Sidebar - style you can find in sidebar.scss
+/! ==============================================================
+aside.left-sidebar
+  /! Sidebar scroll
+  .scroll-sidebar
+    /! Sidebar navigation
+    nav.sidebar-nav
+      ul#sidebarnav
+        / li.nav-small-cap Project title
+        li
+          = link_to '#' do
+            i.fa.fa-user
+            span.hide-menu Menu
+
+  /! Bottom points
+  .sidebar-footer
+    / a.link data-toggle="tooltip" href="" title="Settings"
+    /   i.ti-settings
+    / a.link data-toggle="tooltip" href="" title="Email"
+    /   i.mdi.mdi-gmail
+    a.link data-toggle="tooltip" href=destroy_admin_session_path title="Logout" data-method="DELETE"
+      i.mdi.mdi-power

data/config/webpack/environment.js

@@ -0,0 +1,24 @@
+const { environment } = require('@rails/webpacker')
+
+const webpack = require('webpack');
+
+environment.loaders.get('sass').use.splice(-1, 0, {
+  loader: 'resolve-url-loader'
+});
+
+environment.loaders.append('expose-loader', {
+  test: require.resolve('jquery'),
+  use: [{
+    loader: 'expose-loader',
+    options: '$'
+  }]
+})
+
+environment.plugins.append('Provide', new webpack.ProvidePlugin({
+  $: 'jquery',
+  jQuery: 'jquery',
+  "window.jQuery": 'jquery',
+  Popper: ['popper.js', 'default']
+}));
+
+module.exports = environment

data/lib/generators/crud/crud_generator.rb

@@ -0,0 +1,194 @@
+# frozen_string_literal: true
+
+class CrudGenerator < Rails::Generators::NamedBase
+  include Rails::Generators::Actions
+
+  class_option :options, type: :string, default: ''
+
+  # NOTE: Must use singular for resource param
+
+  # TODO: customize dir prefix
+  WEBPACKER_DIR_PREFIX = 'javascript'
+
+  def create_files
+    p 'Create js controller file...'
+
+    create_file "#{Rails.root}/app/#{WEBPACKER_DIR_PREFIX}/src/javascripts/#{layout_name}/controllers/#{resource}_controller.js" do
+      <<~js
+        import { Controller } from "stimulus";
+        import initDatatable from '../../lib/utils_datatables.js';
+
+        export default class extends Controller {
+          connect() {
+            if (!$('body').hasClass('#{layout_name}-#{resource}')) return false;
+
+            if (!$('table##{resource}-datatable').hasClass('dataTable')) {
+              initDatatable($('##{resource}-datatable'), { searching: true });
+            }
+          }
+        }
+      js
+    end
+
+    p 'Create resource template files...'
+
+    create_file "#{Rails.root}/app/views/#{layout_name}/#{resource}/index.html.slim" do
+      <<~html
+        = content_for :breadcrumb do
+          = render '#{layout_name}/shared/breadcrumb',
+            title: ''
+
+        .col-12
+          .card
+            .card-body
+              = dt id: '#{resource}-datatable', class: 'table', 'data-url': #{layout_name}_#{resource}_path do
+                = dt_col('email', data: { data: 'email' })
+                | TODO
+      html
+    end
+
+    create_file "#{Rails.root}/app/views/#{layout_name}/#{resource}/new.html.slim" do
+      <<~html
+        = content_for :breadcrumb do
+          = render 'admin/shared/breadcrumb',
+            title: '#{resource.camelize}',
+            links: [{ text: '#{resource.camelize}', link: admin_#{resource}_path }, { text: '添加' }]
+
+        = render 'form', url: admin_#{resource}_path
+      html
+    end
+
+    create_file "#{Rails.root}/app/views/#{layout_name}/#{resource}/edit.html.slim" do
+      <<~html
+        = content_for :breadcrumb do
+          = render 'admin/shared/breadcrumb',
+            title: '#{resource.camelize}',
+            links: [{ text: '#{resource.camelize}', link: admin_#{resource}_path }, { text: '编辑' }]
+
+        = render 'form', url: admin_#{name}_path
+      html
+    end
+
+    create_file "#{Rails.root}/app/views/#{layout_name}/#{resource}/_form.html.slim" do
+      <<~html
+        .col-lg-12
+          .card
+            .card-body
+              = form_for @#{name}, url: url, html: { class: 'form-horizontal' } do |f|
+                .form-body
+                  .form-group.row
+                    // TODO:
+                    // = f.label :'', '', class: 'control-label text-right col-md-3'
+                    // .col-md-6
+                    //   = f.text_field :'', class: 'form-control', required: true, placeholder: ''
+
+                .form-actions.text-center
+                  = f.submit '保存', class: 'btn btn-success waves-effect waves-light m-r-10'
+                  = link_to '返回', admin_#{resource}_path, class: 'btn btn-inverse waves-effect waves-light'
+      html
+    end
+
+    p 'Create resource index json file...'
+
+    create_file "#{Rails.root}/app/views/#{layout_name}/#{resource}/index.json.jbuilder" do
+      <<~html
+        # frozen_string_literal: true
+
+        datatable_json_response(json) do
+          json.array! @rows do |row|
+          end
+        end
+      html
+    end
+
+    p 'Create resource controller file...'
+
+    create_file "#{Rails.root}/app/controllers/#{layout_name}/#{resource}_controller.rb" do
+      <<~controller
+        # frozen_string_literal: true
+
+        class #{layout_name.camelize}::#{resource.camelize}Controller < #{layout_name.camelize}::BaseController
+
+          include DatatableDecorator
+
+          def index
+            respond_to do |format|
+              format.html
+              format.json { fetch_#{resource} }
+            end
+          end
+
+          def new
+            @#{name} = #{name.camelize}.new
+          end
+
+          def edit
+            @#{name} = #{name.camelize}.find(params[:id])
+          end
+
+          private
+
+          def fetch_#{resource}
+            dt = decode_datatable_params
+
+            search_obj = { order: dt[:sort_statement] }
+
+            search_text = dt[:search_text]
+
+            #{resource} =
+              if search_text.present?
+                #{name.camelize}.where('nickname ilike ?', "%\#\{search_text\}\%")
+              else
+                #{name.camelize}.all
+              end
+
+            @total_rows = #{resource}.count
+
+            @rows = users.page(dt[:page]).per(dt[:per_page])
+            @rows = @rows.order(search_obj[:order])
+          end
+        end
+      controller
+    end
+
+    p "Create #{name} model..."
+
+    system("rails generate model #{name}")
+  end
+
+  def need_modify
+    p '****************************************************'
+    p '****************************************************'
+  end
+
+  def prompt_modify_migration
+    p "Need change #{resource} migration file then run migration manually..."
+  end
+
+  def prompt_add_routes
+    p "Need add routes for #{resource} in #{layout_name} namespace manually..."
+  end
+
+  def prompt_uncomment_stimulus_controllers
+    p 'Remember to uncomment stimulus js controllers'
+  end
+
+  def end
+    p '****************************************************'
+    p '****************************************************'
+  end
+
+  private
+
+  def resource
+    name.pluralize
+  end
+
+  def layout_name
+    opts.fetch(:layout_name, 'admin')
+  end
+
+  def opts
+    options['options'].split(' ').map { |ele| ele.split(':') }.to_h.symbolize_keys
+  end
+end

data/lib/generators/material_admin/material_admin_generator.rb

@@ -0,0 +1,259 @@
+# frozen_string_literal: true
+
+class MaterialAdminGenerator < Rails::Generators::NamedBase
+  include Rails::Generators::Actions
+
+  GEM_NAME = 'material_admin'
+  GEM_PATH = Gem.loaded_specs[GEM_NAME].full_gem_path
+  JS_PKGS  =
+    'datatables.net-bs4 datatables.net-responsive-bs4'\
+    ' expose-loader file-loader url-loader resolve-url-loader'\
+    ' rails-ujs stimulus turbolinks'\
+    ' jquery popper.js select2'
+
+  # TODO: Warning! Add reset project.
+
+  # TODO: customize dir prefix
+  WEBPACKER_DIR_PREFIX = 'javascript'
+
+  class_option :layout_name, type: :string, default: 'admin'
+  class_option :options, type: :string, default: []
+
+  def add_gems
+    p 'Add gems...'
+
+    gem 'slim'
+    gem 'devise'
+    gem 'kaminari'
+
+    system('bundle install')
+  end
+
+  def import_files
+    p 'Import material admin theme files...'
+
+    webpacker_dir = "#{Rails.root}/app/#{WEBPACKER_DIR_PREFIX}"
+
+    FileUtils.mkdir_p("#{webpacker_dir}/vendor") unless File.directory?("#{webpacker_dir}/vendor")
+
+    FileUtils.copy_entry("#{GEM_PATH}/vendor/#{GEM_NAME}", "#{webpacker_dir}/vendor/#{GEM_NAME}/")
+
+    p 'Import package.json...'
+
+    FileUtils.cp "#{GEM_PATH}/package.json", "#{Rails.root}/package.json"
+
+    p 'Import js source files...'
+
+    FileUtils.copy_entry("#{GEM_PATH}/vendor/javascript", webpacker_dir)
+
+    p 'Import datatable files...'
+
+    FileUtils.cp(
+      "#{GEM_PATH}/app/controllers/concerns/datatable_decorator.rb",
+      "#{Rails.root}/app/controllers/concerns/datatable_decorator.rb"
+    )
+
+    FileUtils.cp(
+      "#{GEM_PATH}/app/helpers/datatables_helper.rb",
+      "#{Rails.root}/app/helpers/datatables_helper.rb"
+    )
+  end
+
+  def create_helper
+    p "Create #{layout_name} layout helper..."
+
+    create_file "#{Rails.root}/app/helpers/#{layout_name}_helper.rb" do
+      <<~helper
+        # frozen_string_literal: true
+
+        module #{layout_name.camelize}Helper
+          def body_id
+            ctrl_name = controller_path.gsub(%r{^v\d+/}, '').tr('/', '-')
+            [ctrl_name, action_name].map(&:dasherize).join('-')
+          end
+
+          def body_class
+            controller_path.gsub(%r{^v\d+/}, '').tr('/', '-').dasherize
+          end
+
+          def body_data_controller
+            @body_data_controller ||= controller_name.tr('_', '-').split('/').join('-')
+          end
+        end
+      helper
+    end
+  end
+
+  def create_js_manifest
+    p "Create #{layout_name} js manifest..."
+
+    src = "#{GEM_PATH}/vendor/javascript/packs/admin.js"
+    dest = "#{Rails.root}/app/#{WEBPACKER_DIR_PREFIX}/packs/#{layout_name}.js"
+
+    FileUtils.cp src, dest
+  end
+
+  def create_style_manifest
+    p "Create #{layout_name} style js manifest..."
+
+    src = "#{GEM_PATH}/vendor/javascript/packs/admin_style.js"
+    dest = "#{Rails.root}/app/#{WEBPACKER_DIR_PREFIX}/packs/#{layout_name}_style.js"
+
+    FileUtils.cp src, dest
+  end
+
+  def create_layout
+    p "Create #{layout_name} layout..."
+
+    layout_html_path = "#{Rails.root}/app/views/layouts/#{layout_name}.html.erb"
+    File.rename(layout_html_path, "#{options['layout_name']}.html.slim") if File.exist?(layout_html_path)
+
+    src = "#{GEM_PATH}/app/views/layouts/admin.html.slim"
+    dest = "#{Rails.root}/app/views/layouts/#{layout_name}.html.slim"
+
+    FileUtils.cp src, dest
+
+    src = "#{GEM_PATH}/app/views/layouts/unauthorized.html.slim"
+    dest = "#{Rails.root}/app/views/layouts/unauthorized.html.slim"
+
+    FileUtils.cp src, dest
+  end
+
+  def create_partials
+    p "Create #{layout_name} shared partials..."
+
+    dest = "#{Rails.root}/app/views/#{layout_name}/shared"
+
+    FileUtils.mkdir_p(dest) unless File.directory?(dest)
+
+    FileUtils.copy_entry("#{GEM_PATH}/app/views/shared", dest)
+  end
+
+  def yarn_install
+    system("yarn add #{JS_PKGS}")
+  end
+
+  def create_base_controller
+    p "Create base controller'"
+
+    create_file "#{Rails.root}/app/controllers/#{layout_name}/base_controller.rb" do
+      <<~dashboard_controller
+        # frozen_string_literal: true
+
+        class #{layout_name.camelize}::BaseController < ActionController::Base
+          layout '#{layout_name}'
+
+          before_action :authenticate_#{layout_name}!
+        end
+      dashboard_controller
+    end
+  end
+
+  def create_dashboard_controller
+    p 'Create dashboard controller...'
+
+    create_file "#{Rails.root}/app/controllers/#{layout_name}/dashboard_controller.rb" do
+      <<~dashboard_controller
+        # frozen_string_literal: true
+
+        class #{layout_name.camelize}::DashboardController < #{layout_name.camelize}::BaseController
+          def index
+          end
+        end
+      dashboard_controller
+    end
+  end
+
+  def create_sessions_controller
+    p "Create #{layout_name} sessions controller..."
+
+    create_file "#{Rails.root}/app/controllers/#{layout_name}/sessions_controller.rb" do
+      <<~sessions_controller
+        # frozen_string_literal: true
+
+        class Admin::SessionsController < Devise::SessionsController
+          layout 'unauthorized'
+        end
+      sessions_controller
+    end
+  end
+
+  def create_dashboard_view
+    p 'Create dashboard view...'
+
+    create_file "#{Rails.root}/app/views/#{layout_name}/dashboard/index.html.slim" do
+      <<~dashboard_page
+        h1 Welcome come back🙂
+      dashboard_page
+    end
+  end
+
+  def create_new_session_file
+    p 'Create sign_in template...'
+
+    dir = "#{Rails.root}/app/views/#{layout_name}/sessions/"
+
+    FileUtils.mkdir_p(dir) unless File.directory?(dir)
+
+    FileUtils.cp(
+      "#{GEM_PATH}/app/views/#{layout_name}/sessions/new.html.slim",
+      "#{Rails.root}/app/views/#{layout_name}/sessions/new.html.slim"
+    )
+  end
+
+  def init_db
+    p 'Init db...'
+
+    system('rake db:drop db:create')
+
+    p 'Init devise...'
+    system('rails g devise:install')
+    system("rails generate model #{layout_name}")
+    system("rails generate devise #{layout_name}")
+    system('rake db:migrate')
+  end
+
+  def modify_webpacker_environment_file
+    p 'Overwrite config webpack environment js file'
+
+    src = "#{GEM_PATH}/config/webpack/environment.js"
+    dest = "#{Rails.root}/config/webpack/environment.js"
+
+    FileUtils.cp src, dest
+  end
+
+  def need_modify
+    p '****************************************************'
+    p '****************************************************'
+  end
+
+  def prompt_confit_route
+    puts "Need change the devise default route to:\n"
+    routes = <<~routes
+      devise_for :#{layout_name},
+        path: '#{layout_name}',
+        controllers: { sessions: '#{layout_name}/sessions' }
+
+      namespace :#{layout_name} do
+        root 'dashboard#index'
+      end
+    routes
+    puts routes
+  end
+
+  def prompt_extract_css
+    puts "Need set extract_css to true in webpacker.yml\n"
+    p 'extract_css: true'
+  end
+
+  def at_end
+    p '****************************************************'
+    p '****************************************************'
+  end
+
+  private
+
+  def layout_name
+    options['layout_name']
+  end
+end

data/lib/material_admin.rb

@@ -0,0 +1,5 @@
+require "material_admin/railtie"
+
+module MaterialAdmin
+  # Your code goes here...
+end

data/lib/material_admin/railtie.rb

@@ -0,0 +1,4 @@
+module MaterialAdmin
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/material_admin/version.rb

@@ -0,0 +1,3 @@
+module MaterialAdmin
+  VERSION = '0.1.0'
+end

data/lib/tasks/material_admin_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :material_admin do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: rails_material_admin
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tracy Cai
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-06-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.2.4
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.2.4
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.4.3
+description: Quickly start admin page using Material Admin Pro theme.
+email:
+- 835010809@qq.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/controllers/concerns/datatable_decorator.rb
+- app/helpers/admin_helper.rb
+- app/helpers/datatables_helper.rb
+- app/views/admin/sessions/new.html.slim
+- app/views/layouts/admin.html.slim
+- app/views/layouts/unauthorized.html.slim
+- app/views/shared/_breadcrumb.html.slim
+- app/views/shared/_error_messages.html.slim
+- app/views/shared/_header.html.slim
+- app/views/shared/_links.html.slim
+- app/views/shared/_radio_box.html.slim
+- app/views/shared/_sidebar.html.slim
+- config/webpack/environment.js
+- lib/generators/crud/crud_generator.rb
+- lib/generators/material_admin/material_admin_generator.rb
+- lib/material_admin.rb
+- lib/material_admin/railtie.rb
+- lib/material_admin/version.rb
+- lib/tasks/material_admin_tasks.rake
+homepage: https://github.com/NaiveCAI/material_admin_rails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.10
+signing_key: 
+specification_version: 4
+summary: Quickly start admin page using Material Admin Pro theme.
+test_files: []