geraldo_junior_arctic_admin
Version:
Responsive Theme for ActiveAdmin
147 lines (95 loc) • 3.34 kB
Markdown
# ArcticAdmin
[](https://rubygems.org/gems/arctic_admin)
[](https://rubygems.org/gems/arctic_admin)
[](https://www.npmjs.com/package/arctic_admin)
[](https://www.npmjs.com/package/arctic_admin)
Simple theme for ActiveAdmin :ok_hand:
>**Complete demo here : https://arctic-admin.herokuapp.com/**
>
>*admin user : admin@example.com / password*
## Installation
>**⚠️ If you are using webpacker (Standard with Rails 6) look below**
- Add this to your Gemfile:
```ruby
gem 'arctic_admin'
```
- Run `bundle install`.
- Add this line to the file `config/initializers/active_admin.rb`
```ruby
meta_tags_options = { viewport: 'width=device-width, initial-scale=1' }
config.meta_tags = meta_tags_options
config.meta_tags_for_logged_out_pages = meta_tags_options
```
## Usage
### CSS
In your `active_admin.css`, include the css file:
```css
/*
*= require arctic_admin/base
*/
```
**Remove the line `*= require active_admin/base`**
Then restart your webserver if it was previously running.
### Sass Support
:exclamation: **Remove the line `@import "active_admin/base"`**
If you prefer [SCSS](http://sass-lang.com/documentation/file.SASS_REFERENCE.html), add this to your
`active_admin.scss` file:
```scss
@import "arctic_admin/base";
```
If you use the
[Sass indented syntax](http://sass-lang.com/docs/yardoc/file.INDENTED_SYNTAX.html),
add this to your `active_admin.sass` file:
```sass
@import arctic_admin/base
```
### JS
In your `active_admin.js`, include the js file:
```js
//= require arctic_admin/base
```
:exclamation: **Remove the line `//= require active_admin/base`**
## Use with webpacker
### 1 - Preparation
Install the needed assets with npm or yarn:
```
yarn add arctic_admin @fortawesome/fontawesome-free
```
### 2 - CSS
In your `app/javascript/stylesheets/active_admin.scss`, add the line:
```scss
@import '~arctic_admin/src/scss/main';
```
Remove:
```scss
@import "~@activeadmin/activeadmin/src/scss/mixins";
@import "~@activeadmin/activeadmin/src/scss/base";
```
### 3 - JS
Search for `app/javascript/packs/active_admin.js` in your rails project and add the following lines:
```js
import "@fortawesome/fontawesome-free/css/all.css";
import 'arctic_admin'
```
### Customization
For this, you need to use SASS to customize the theming.
Right now you can change the primary color of the theme by placing the following variable in your `active_admin.scss` file:
```scss
$primary-color: #2dbb43;
@import "~arctic_admin/src/scss/main";
```
If you use the
[Sass indented syntax](http://sass-lang.com/docs/yardoc/file.INDENTED_SYNTAX.html),
add this to your `active_admin.sass` file:
```sass
$primary-color: #2dbb43
@import ~arctic_admin/src/scss/main
```
Then restart your webserver if it was previously running.
## Contributing
1. Fork it ( https://github.com/cprodhomme/arctic_admin/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 new Pull Request