Popularity
7.1
Stable
Activity
8.1
Growing
1,640
55
129

Monthly Downloads: 14,323
Programming language: Ruby
License: GNU Lesser General Public License v3.0 only
Latest version: v0.9.4

Trestle alternatives and similar gems

Based on the "Admin Interface" category.
Alternatively, view Trestle alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Trestle or a related project?

Add another 'Admin Interface' Gem

README

Trestle

RubyGem Travis Coveralls Code Climate

Demo Site | Demo Source Code

A modern, responsive admin framework for Ruby on Rails

Getting Started

To start using Trestle, first add it to your application's Gemfile:

gem 'trestle'

Run bundle install, and then run the install generator to create the initial configuration file and customization hooks:

$ rails generate trestle:install

Then create your first admin resource (assuming you have an existing Article model):

$ rails generate trestle:resource Article

After restarting your Rails server, visit http://localhost:3000/admin to view your newly created admin. You will find the admin definition in app/admin/articles_admin.rb ready to customize.

Example

Trestle.resource(:posts) do
  # Add a link to this admin in the main navigation
  menu do
    group :blog_management, priority: :first do
      item :posts, icon: "fa fa-file-text-o"
    end
  end

  # Define custom scopes for the index view
  scopes do
    scope :all, default: true
    scope :published
    scope :drafts, -> { Post.unpublished }
  end

  # Define the index view table listing
  table do
    column :title, link: true
    column :author, ->(post) { post.author.name }
    column :published, align: :center do |post|
      status_tag(icon("fa fa-check"), :success) if post.published?
    end
    column :updated_at, header: "Last Updated", align: :center
    actions
  end

  # Define the form structure for the new & edit actions
  form do
    # Organize fields into tabs and sidebars
    tab :post do
      text_field :title

      # Define custom form fields for easy re-use
      editor :body
    end

    tab :metadata do
      # Layout fields based on a 12-column grid
      row do
        col(sm: 6) { select :author, User.all }
        col(sm: 6) { tag_select :tags }
      end
    end

    sidebar do
      # Render a custom partial: app/views/admin/posts/_sidebar.html.erb
      render "sidebar"
    end
  end
end

Plugins

The following plugins are currently available:

Name Description Links
trestle-auth User authentication plugin GitHub \
trestle-search Search plugin GitHub \
trestle-tinymce TinyMCE (WYSIWYG editor) integration GitHub \
trestle-simplemde SimpleMDE (Markdown editor) integration GitHub \
trestle-sidekiq Sidekiq integration GitHub \
trestle-active_storage Active Storage integration GitHub \
trestle-mobility Mobility integration GitHub \
trestle-omniauth OmniAuth authentication plugin GitHub \
trestle-auth-otp 2FA/OTP user authentication GitHub \

Development

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for information on developing and contributing to Trestle.

License

The gem is available as open source under the terms of the LGPLv3 License.


*Note that all licence references and agreements mentioned in the Trestle README section above are relevant to that project's source code only.