five-for-the-future/themes/wporg-5ftf/css/README.md
Kelly Dwan ef8c78f4f3
Update and document CSS structure
Looking at ITCSS, it appears the last level should be `utilities`. Since that's a name that has no negative connotations, let's use that instead. Also add a README documenting each folder's use.
2019-10-02 10:57:31 -04:00

1 KiB

CSS Structure

This loosely follows ITCSS.

01 Settings

Typography, colors, any spacing variables, etc should be set here.

02 Tools

This contains any mixins. We inherit the following libraries:

  • breakpoint
  • kube
  • modular-scale

03 Generic

Any generic styles. Used for normalize & reset styles. We inherit:

  • kube
  • normalize

04 Base (aka Elements)

Styles for plain html elements. We inherit the base theme's styling here.

05 Objects

These are pieces of UI. These should be self-contained (or nested so that they are self-contained). Blocks should be defined here.

06 Components

This section puts together the base and objects to create pages. Page-specific styles are defined here.

07 Utilities

The is-*/has-* classes, these custom classes override previous styles. For example, has-background would be defined here. This is where block styles should live.

Editor Styles

Editor styles will use a custom import of a subset of the above folders, TBD?