AlloyCSS Core
Quick start
In your command line application, you will want to install the necessary tools
to start working on the UI framework. Make sure your other projects are at the
same level for synced releases.
Install
Note: Yarn only applies to you if your only using this framework, otherwise figwheel will install all the npm packages for you
- Soon Download the latest release
- Clone the repo:
git clone https://github.com/AlloyCSS/core.git
- Install npm
- Install with yarn
Development
If you're actively working on changing CSS rules in this library, you
will want to clone this repository and run these commands:
npm i -g gulp
npm i
gulp watch
Publishing
For now, I think a PR for version bump is good enough.
index.html
Make sure to add these things to your layout file. Optionally, for legacy browser support of HTML5 and layout, you can import modernizr/cdn into your head section.
<html class="s-app">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
<link rel="stylesheet" href="/path/to/main.css">
</head>
To continue on the path of layout, refer to the example layout section in the CSS Guide.
Layers
This UI framework consists of multiple UI layers that serve their own purposes.
<div class="u-row u-center">
<code>.utilities</code>
</div>
<div class="u-row u-center">
<a href="#elements">Elements</a>
<div class="u-row u-center">
<button class="c-button c-button--large">Components</button>
<div class="u-row u-center">
<span class="c-button-group__label"><strong>Objects</strong></span>
<div class='c-button-group--toggle'>
<button class='c-button c-button--small'>Component</button>
<button class='c-button c-button--small c-button--text'>Element</button>
</div>
</div>
Syntax
Synopsis - Give developers more knowledge about how the classes behave in a non-relative sense: BEM + ITCSS = BEMIT
Sources
More Transparent UI Code with Namespaces
BEMIT: Taking the BEM Naming Convention a Step Further
Anatomy
.namespace-block__element--modifier\@media { }
Namespaces
.o-object-name[<element>/<modifier>] {}
.c-component-name[<element>/<modifier>] {}
.u-utility-name {}
.t-theme-name {}
.s-scope-name {}
.[is/has]-state {}
._<namespace>hack-name {}
.js-component-name {}
.qa-node-name {}
Responsive Suffixes
Breakpoints
.o-object-name\@sm {}
.o-object-name\@md {}
.o-object-name\@lg {}
Media type
.u-utility-name\@print {}