ember-myth
v0.1.1
Published
Myth for ember-cli - css the way it was imagined
Downloads
36
Readme
ember-myth
Preprocess your CSS using Myth.
Myth is a preprocessor that lets you write pure CSS without having to worry about slow browser support, or even slow spec approval. It's like a CSS polyfill.
Installation
npm install --save-dev ember-myth
Usage
By default, this addon will compile app/styles/<app-name>.css
into dist/assets/<app-name>.css
. To change this, use the configuration object (explained below) and set the property: outputFile
.
Options can be configured within your Brocfile.js
or from within config/environment.js
:
// Brocfile.js
var app = new EmberApp({
mythOptions: {...}
...
});
module.exports = function (/* env */) {
return {
mythOptions: {...}
...
}
};
Myth Example
/* app.css */
:root {
--purple: #847AD1;
--large: 10px;
}
a {
color: var(--purple);
transition: color .2s;
}
a:hover {
color: color(var(--purple) tint(20%));
}
pre {
padding: var(--large);
margin: calc(var(--large) * 2);
}
Available Options
browsers
-Array
- an array of browsers and versions to support.compress
-Boolean
- whether to compress the CSS output.source
-String
- the full path to the source CSS file. This is necessary if you want Myth to concatenate@import
rules in your CSS. Default:<project-path>/app/styles/app.css
features
-Object
- any features you'd like to disable. All features are enabled by default. For example:
features: {
import: false,
variables: false,
customMedia: false,
hexAlpha: false,
color: false,
calc: false,
fontVariant: false,
rebeccapurple: false,
prefixes: false
}
Why Myth?
Myth lets you write pure CSS while still giving you the benefits of tools like LESS and Sass. You can still use variables and math functions, just like you do in preprocessors. It's like a polyfill for future versions of the spec.
Some of the features in CSS require runtime calculations, which neither Myth nor preprocessors handle, but what Myth does is let you write your code today in the future syntax, so that your code is future-proof. When browsers finally support these features you won't need to rewrite anything, just start using the cascade!
Taking plain CSS as an input also means you can use Myth to re-process anyone else's CSS (or another preprocessors output), adding the browser support you need, without having to re-write the code in a completely different syntax.
Myth is built with Rework so it's incredibly fast, and has a nice Javascript API in addition to the CLI.
(Credits: myth#why)