/sprucecss-root-admin-template

A static HTML/CSS/JS administration tempalte built on Spruce CSS.

Primary LanguageHTMLOtherNOASSERTION


Spruce CSS

This repository contains the static template of our Laravel admin named Root.

The preview image of the template.

The template is built with Eleventy for our sanity and easier management. You can grab the content from the Nunjucks template files or the compiled dist folder.

The template will probably change regularly in the future because of the Laravel package development.

What You Get

We used Alpine.js to handle the JS code. Although there are some quite complete JS behaviors, this template is still static HTML/CSS, so you have to do the interactive part.

Right now, you can grab the following views or layouts:

There are a lot of admin-specific components:

  • Modal window with customizations.
  • Data table block with search and filter support.
  • Simple search.
  • Various drop-down menus.
  • Widget cards.
  • Media handler modal.
  • Combobox.

Get Up and Running

We use eleventy --serve and compile Sass with sass-cli with npm scripts.

  1. Clone the repository.

  2. Install the dependencies.

    In the package.json file, you will find all of the dependencies (and scripts) to install them using the following command:

    npm install
  3. Run the development mode

    To run the development mode, use the npm script. This script will also watch for changes.

    npm start
  4. Run the production mode

    Before you go live, you should use the production script to compress the Sass files.

    npm run prod

SCSS

The project compiles the SCSS files from the ./src/scss folder into the ./src/css folder. The project includes Spruce CSS, which gives the styling with some Spruce UI components.

Other Scripts

  • sass:lint/sass:lint:fix You can lint your SCSS files with Stylelint and stylelint-config-sass-guidelines preset with the npm run sass:lint command. Use the npm run sass:lint:fix command if you want automatic fixes.

  • js:lint/js:lint:fix You can also lint your JS like with Sass. For the rules, we use the Airbnb preset.

License

The code is licensed under the MIT.