Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicovak/slash_admin
A modern and customizable admin gem, just the rails way.
https://github.com/nicovak/slash_admin
admin admin-dashboard hacktoberfest rails ruby ruby-on-rails
Last synced: 3 days ago
JSON representation
A modern and customizable admin gem, just the rails way.
- Host: GitHub
- URL: https://github.com/nicovak/slash_admin
- Owner: nicovak
- License: mit
- Created: 2017-05-13T14:35:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-12-16T09:35:58.000Z (about 3 years ago)
- Last Synced: 2024-10-22T23:18:01.765Z (3 months ago)
- Topics: admin, admin-dashboard, hacktoberfest, rails, ruby, ruby-on-rails
- Language: HTML
- Homepage:
- Size: 848 KB
- Stars: 13
- Watchers: 3
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: docs/security.md
Awesome Lists containing this project
README
# SlashAdmin
[](https://badge.fury.io/rb/slash_admin)
[](https://circleci.com/gh/nicovak/slash_admin/tree/master)
A modern and fully customizable admin, just the rails way.
Embedded admin user and authentication system, devise is not needded.
❤️ [Demo repository](https://github.com/nicovak/slash_admin_demo)
🚀 [Live running](https://slashadmin.herokuapp.com/admin)
User
`admin`
Password
`admin@admin`
#### Motivation:
- Provide to Ruby On Rails the admin it deserves without DSL or obscure logic.
- Provide an easy to use and modern experience to final users.
I tried to take the best from two greats existing gem:
- [rails_admin](https://github.com/sferik/rails_admin)
- [administrate](https://github.com/thoughtbot/administrate)
Design inspired from the awesome metronic admin theme:
- [keenthemes](http://keenthemes.com/preview/metronic/)
#### Screenshots
##### Login
##### Dashboard
##### List
##### Edit / Create
### Installation
Add this line to your application's Gemfile:
```ruby
gem 'slash_admin'
```
Then execute:
```bash
$ bundle install
```
Or install it yourself as:
```bash
$ gem install slash_admin
```
Gemfile
```
gem 'carrierwave'
```
Then:
```bash
$ rails g slash_admin:install
$ rails slash_admin:install:migrations
$ rails db:migrate
```
`config/initializers/mime_types.rb`
```ruby
Mime::Type.register "application/xls", :xls
```
If your apps uses Sprockets 4+, you'll need to add SlashAdmin assets to your `manifest.js` file. To do this, add these two lines to the file:
`app/assets/config/manifest.js`
```
//= link slash_admin/application.css
//= link slash_admin/application.js
```
`config/routes.rb`
```ruby
Rails.application.routes.draw do
mount SlashAdmin::Engine => "/"
end
```
Mounted as '/' but prefixed in the gem and in routes definition of models admin. See the full example above.
```ruby
Rails.application.routes.draw do
mount SlashAdmin::Engine => "/"
namespace :slash_admin, path: "/admin" do
scope module: 'models' do
resources :pages # assume Page model
end
end
end
```
### Important
If you are using [friendly_id](https://github.com/norman/friendly_id) gem, you have to add `routes: :default` like so:
```ruby
friendly_id :title, use: :history, routes: :default
```
Example of create admin in `seed.rb` in your app:
```ruby
SlashAdmin::Admin.create!(
username: 'admin',
email: '[email protected]',
password: 'admin@admin',
password_confirmation: 'admin@admin'
)
```
### Documentation
[Read the docs](https://github.com/nicovak/slash_admin/tree/master/docs/index.md)
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/nicovak/slash_admin. 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).
## Code of Conduct
Everyone interacting in the slash_admin project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/nicovak/slash_admin/tree/master/CODE_OF_CONDUCT.md).