https://github.com/armordarks/ekzo

:dizzy: Functional Sass framework for rapid and painless development
https://github.com/armordarks/ekzo

atomic atomic-css bem bem-methodology css design-free framework frontend-framework functional functional-css grid mixins modern-browsers modular object-oriented oocss responsive sass sass-framework typography

Last synced: 2 days ago
JSON representation

:dizzy: Functional Sass framework for rapid and painless development

• Host: GitHub
• URL: https://github.com/armordarks/ekzo
• Owner: ArmorDarks
• License: apache-2.0
• Created: 2013-11-12T16:23:35.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2019-08-04T10:34:35.000Z (about 5 years ago)
• Last Synced: 2024-04-26T10:21:19.632Z (5 months ago)
• Topics: atomic, atomic-css, bem, bem-methodology, css, design-free, framework, frontend-framework, functional, functional-css, grid, mixins, modern-browsers, modular, object-oriented, oocss, responsive, sass, sass-framework, typography
• Language: CSS
• Homepage:
• Size: 820 KB
• Stars: 33
• Watchers: 2
• Forks: 3
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
![Ekzo](https://cloud.githubusercontent.com/assets/4460311/23854875/16890190-07fc-11e7-862e-37f5a69b76a3.png)



  
Sass framework

  
Functional, Atomic, OOCSS-driven, layered, design-free, BEM-based, responsive and mighty



---



  

    

  



How to use

----------

Install framework with NPM:

```shell

npm install ekzo --save

```

Import parts you would like to use, like:

```scss

@import 'node_modules/ekzo/tools/index';

@import 'node_modules/ekzo/settings.defaults/assets';

@import 'node_modules/ekzo/settings.defaults/framework';

@import 'node_modules/ekzo/settings.defaults/misc';

@import 'node_modules/ekzo/settings.defaults/options';

@import 'node_modules/ekzo/settings.defaults/responsive';

@import 'node_modules/ekzo/settings.defaults/themes';

@import 'node_modules/ekzo/settings.defaults/typography';

@import 'node_modules/ekzo/base/normalize';

@import 'node_modules/ekzo/generic/shared';

@import 'node_modules/ekzo/generic/headings';

@import 'node_modules/ekzo/generic/text';

@import 'node_modules/ekzo/objects/grid';

@import 'node_modules/ekzo/helpers/flex';

@import 'node_modules/ekzo/helpers/spacing';

@import 'node_modules/ekzo/helpers/typography';

@import 'node_modules/ekzo/helpers/widths';

```

Imports should be layered in following order:

* [Tools](https://github.com/ArmorDarks/ekzo/tree/master/tools)

* Predefined variables

* Settings (or [default settings](https://github.com/ArmorDarks/ekzo/tree/master/settings.defaults))

* [Base styles](https://github.com/ArmorDarks/ekzo/tree/master/base)

* [Generics](https://github.com/ArmorDarks/ekzo/tree/master/generic)

* [Objects](https://github.com/ArmorDarks/ekzo/tree/master/objects)

* Components

* [Helpers](https://github.com/ArmorDarks/ekzo/tree/master/helpers)

Refer to [Kotsu](https://github.com/LotusTM/Kotsu) `style.scss` as an [example](https://github.com/LotusTM/Kotsu/tree/master/source/styles).

Requirements

------------

[Sass](http://sass-lang.com/install) 3.4.2 or higher.

[Autoprefixer](https://github.com/postcss/autoprefixer) is highly advised.

Browsers support

----------------

|  IE | Edge | Chrome | Firefox | Safari | Opera | Opera Mobile | iOS Safari | Android |

|-----|------|--------|---------|--------|-------|--------------|------------|---------|

| 10+ | 12+  | 21+    | 28+     | 6.1+   | 12.1+ | 12.1+        | 7.1+       | 4.4+    |

[`_ie.scss`](https://github.com/ArmorDarks/ekzo/blob/master/_ie.scss) provides graceful regression for IE9 and below:

* Grid, media and nav objects will fallback from `flexbox` to `inline-block`, `table` or `float`-based models.

* Flexbox alignment helpers will fallback to `text-align` and `vertical-align` to imitate intended alignment on `inline-block`-based grid, media and nav objects.

* `::placeholder` and `::selection` won't be styled nor displayed.

All this will help to maintain intended flow and alignment of elements as closely as possible, but some features will be limited, especially vertical alignment.

To use, include `_ie.scss` in stylesheet, which will be served only to IE9 and below with [IE conditional comments](https://en.wikipedia.org/wiki/Conditional_comment).

Best used with

--------------

[Kotsu](https://github.com/LotusTM/Kotsu) — Advanced Web Starter Kit & Static Website Generator with docker integration.