Skip to content

Pagepro/libsasserplate

Repository files navigation

LibSasserPlate

LibSass starter for front-end projects by Pagepro.

Requirements

  1. node v8.12.0 or later
  2. yarn
  3. EditorConfig for the code editor of your choice(optional).
  4. Standard plugin for the code editor of your choice(optional).

Getting started

Three simple steps to start:

  1. Install the required libraries.
  2. Get a copy of LibSasserPlate.
  3. Install the dependencies if you don't already have them.

Installing the required libraries

If you require Node, go to nodejs.org and click on the big green Install button.

If you have node already installed on your OS, please make sure you have a supported version running. To check node's version, open a terminal and run:

node --version

Node should respond with a version at or above 8.12.0. If the command is not recognized or nothing happens, you might want to re-install node.

Getting the starter

Download LibSasserPlate and extract it to catalog you want to work.

Local dependencies

Next, install the local development dependencies required by LibSasserPlate. To do that, simply run:

$ yarn install

That's it! You should now have everything needed to use the LibSasserPlate.

Optional(but highly recommended)

Here at Pagepro, we always do our best to write our code high quality. Everyone makes a mistake from time to time, though. That's why we use libraries that help us avoid them as often as possible. Libsasserplate is configured to support both EditorConfig and Standard. Thanks to EditorConfig, your files' settings will be consistent throught the project. Standard is a Javascript linter that keeps your code clean and forces good practices.

Both of them require additional plugins for your IDE and cannot be installed by the starter. We cannot force you to use them, but we highly recommend you do.

Usage

Run development tasks:

To develop using LibSasserPlate, run:

yarn start

This will start a local server and watch files for changes.

Build production files:

yarn run production

Instructions

Some of the pre-defined functionality might seem intimidating at first. You can read on how to use it in the detailed instruction manual.

Directory structure explanation

  • / - root directory with html files and configuration files (eslint, editorconfig)
  • src - directory with source files
  • static - directory compiled files, do not edit files in this directory because they will be overwritten