Skip to content

AdminLTE - Free Premium Admin control Panel Theme That Is Based On Bootstrap 3.x

License

Notifications You must be signed in to change notification settings

aguegu/AdminLTE

 
 

Repository files navigation

admin-lte.scss

This repo is fork from Almsaeed Studio's AdminLTE

The main purpose is to make a SCSS version of it (the origin is in LESS). However, I could not help myself to make more refactory work.

  • build tool convert from grunt to gulp
  • most plugins have been moved to bower.json and upgrade to the latest
  • file structure is adjusted a lot

There were too many deps plugins included in the origin repo. In my point of view, that is way too much job to maintain. And in modern frontend project, most of them can be managed by bower. The main product of this template is its stylesheets and js files, not these plugins. Therefore, since most plugins has been upgraded, in bower.json, to the latest. The output may vary a little bit in the demo pages. But I do not view it as bugs. A little adjustment and tweaks would fix that quite soon.

Because doing the style in the SCSS way, the skins your choose are defined in the main.scss file. it can import all skins as well as signal skin. It all up to you.

install with bower

$ bower install admin-lte.scss

how to test

  1. fork this repo
  2. install deps
   $ npm install -g gulp bower http-server
   $ npm install 
   $ bower install 
   $ gulp
   $ http-server .
  1. Then test it in your browser. default on localhost: 8080

(Below is the origin readme)

Introduction

AdminLTE -- is a fully responsive admin template. Based on Bootstrap 3 framework. Highly customizable and easy to use. Fits many screen resolutions from small mobile devices to large desktops. Check out the live preview now and see for yourself.

Download & Preview on Almsaeed Studio

Looking for Premium Templates?

Almsaeed studio just opened a new premium templates page. Hand picked to insure the best quality and the most affordable prices. Visit https://almsaeedstudio.com/premium for more information.

!["AdminLTE Presentation"] (https://almsaeedstudio.com/AdminLTE2.png "AdminLTE Presentation")

AdminLTE has been carefully coded with clear comments in all of its JS, LESS and HTML files. LESS has been used to increase code customizability.

Installation

There are multiple ways to install AdminLTE.

####Download:

Download from Github or visit Almsaeed Studio and download the latest release.

####Using The Command Line:

Github

git clone https://github.com/YOUR_USERNAME/AdminLTE.git

Bower

bower install admin-lte

Composer

composer require "almasaeed2010/adminlte=~2.0"

Documentation

Visit the online documentation for the most updated guide. Information will be added on a weekly basis.

Browser Support

  • IE 9+
  • Firefox (latest)
  • Chrome (latest)
  • Safari (latest)
  • Opera (latest)

Contribution

Contribution are always welcome and recommended! Here is how:

  • Fork the repository (here is the guide).
  • Clone to your machine git clone https://github.com/YOUR_USERNAME/AdminLTE.git
  • Make your changes
  • Create a pull request

Contribution Requirements:

  • When you contribute, you agree to give a non-exclusive license to Almsaeed Studio to use that contribution in any context as we (Almsaeed Studio) see appropriate.
  • If you use content provided by another party, it must be appropriately licensed using an open source license.
  • Contributions are only accepted through Github pull requests.
  • Finally, contributed code must work in all supported browsers (see above for browser support).

License

AdminLTE is an open source project by Almsaeed Studio that is licensed under MIT. Almsaeed Studio reserves the right to change the license of future releases.

Todo List

  • Light sidebar colors (Done v2.1.0)
  • Right sidebar (Done v2.1.0)
  • Minified main-sidebar (Done v2.1.0)
  • Right to left support
  • Custom pace style

Legacy Realeases

AdminLTE 1.x can be easily upgraded to 2.x using this guide, but if you intend to keep using AdminLTE 1.x, you can download the latest release from the releases section above.

Change log

v2.1.2:

  • Added explicit BoxWidget activation function issue #450
  • Crushed some bugs

v2.1.1:

  • Fix version error

v2.1.0:

  • Update Ion Icons
  • Added right sidebar .control-sidebar
  • Control sidebar has 2 open effects: slide over content and push content
  • Control sidebar converts to always slide over content on small screens
  • Added 6 new light sidebar skins
  • Updated demo menu
  • Added ChartJS preview page
  • Fixed some minor bugs
  • Added light control sidebar skin
  • Added expand on hover option for sidebar mini
  • Added fixed control sidebar layout

v2.0.5:

  • Fixed issue #288

v2.0.4:

  • Fixed bower.json to pick up newest release.

v2.0.3

  • Bug fixes
  • Fixed extra page when printing issue #264
  • Updated documentation and fixed links scrolling issue
  • Created print.less file (this makes it easier if you want to create a seperate CSS file for printing)
  • Fixed sidebar stretching issue #275
  • Fixed checkbox out of bounds issue in WYSIHTML5 editor.

v2.0.2:

  • Solved issue with hidden arrow in select inputs.

v2.0.1:

  • Updated README.md
  • Fixed versioning issue in CSS, LESS, and JS
  • Updated box-shadow for boxes
  • Updated docs

v2.0.0:

  • Major layout bug fixes
  • Change in layout mark up
  • Added transitions to the sidebar
  • New skins and modified previous skins
  • Change in color scheme to a more complementing scheme
  • Added footer support
  • Removed pace.js from the main app.js
  • Added support for collapsed sidebar as an initial state (add .sidebar-collapse to the body tag)
  • Added boxed layout (.layout-boxed)
  • Enhanced consistency in padding and margining
  • Updated Bootstrap to 3.3.2
  • Fixed navbar dropdown menu on small screens positioning issues.
  • Updated Ion Icons to 2.0.0
  • Updated FontAwesome to 4.3.0
  • Added ChartJS 1.0.1
  • Removed iCheck dependency
  • Created Dashboard 2.0
  • Created new Chat widget (DirectChat)
  • Added transitions to DirectChat
  • Added contacts pane to DirectChat
  • Changed .right-side to .content-wrapper
  • Changed .navbar-right to .navbar-custom-menu
  • Removed unused files
  • Updated lockscreen style (HTML markup changed!)
  • Updated Login & Registration pages (HTML markup changed!)
  • Updated buttons style.
  • Enhanced border-radius consistency
  • Added mailbox: inbox, read, and compose pages
  • Bootstrap & jQuery are now hosted locally
  • Created documentation.

ver 1.2.0:

ver 1.1.0:

  • Added new skin. class: .skin-black
  • Added pace plugin.

Image Credits

Pixeden

Graphicsfuel

Pickaface

Unsplash

Uifaces

Donations

Donations are greatly appreciated!

Donate

About

AdminLTE - Free Premium Admin control Panel Theme That Is Based On Bootstrap 3.x

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 83.6%
  • JavaScript 10.6%
  • CSS 5.8%