trestle

Trestle

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

…

Plugins

The following plugins are currently available:

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

Development

Please see 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.