1
0
mirror of https://github.com/locomotivemtl/locomotive-boilerplate.git synced 2026-01-15 00:55:08 +08:00

Change structure/import order of the SCSS to properly follow ITCSS. Add layer description to README.

We were doing it wrong.
This commit is contained in:
Antoine Boulanger
2015-02-15 15:44:11 -05:00
parent a0ccfc62d3
commit 8a335ab020
21 changed files with 511 additions and 366 deletions

View File

@@ -2,3 +2,20 @@ Charcoal-Boilerplate
======================
Boilerplate for [`Charcoal`](#http://charcoal.locomotive.ca) projects by Locomotive.
## SCSS
### Import order
* **Settings:** Global variables, site-wide settings, config switches, etc.
* **Tools:** Site-wide mixins and functions.
* **Generic:** Low-specificity, far-reaching rulesets (e.g. resets).
* **Base:** Unclassed HTML elements (e.g. `a {}`, `blockquote {}`, `address {}`).
* **Objects:** Objects, abstractions, and design patterns (e.g. `.media {}`).
* **Components:** Discrete, complete chunks of UI (e.g. `.carousel {}`). This is
the one layer that inuitcss doesnt get involved with.
* **Trumps:** High-specificity, very explicit selectors. Overrides and helper
classes (e.g. `.hidden {}`).
*From [ITCSS](https://twitter.com/itcss_io)*