ctr
v0.4.1
Published
The CSS Framework
Downloads
26
Maintainers
Readme
ctr
/// The CSS Framework
Description
There are many words/examples you can read in the documentation that detail what, why, and how, but I’ll give a brief overview. ctr
is a CSS framework built with JavaScript to provide object oriented functionality to allow for a rich hierarchy of inherited CSS components to better facilitate a CSS architecture similar to OOCSS. Albeit ctr
and OOCSS differ vastly in application and you construct your CSS in ctr
using true objects which allows for ctr
to be constructed in YAML, JavaScript, and Less. Although ctr
shares the same goal of OOCSS - encouraging code reuse as well as maintainable CSS styles.
The object oriented architecture of ctr
also allows for a rich hierarchy of inherited CSS components so that it’s not required to list each class in your HTML every single time. A functionality that is encompassed through the class feature of ctr
. An idea presented by Philip Walton and his article The Future of OOCSS: A Proposal. However, to accomplish this, there has to be a supporting framework, and that is what ctr
and all its various features provide.
My favorite feature of ctr
is its ability to abstract away the tedium and pain-points from creating complex CSS logic for pseudo-classes such as hover
, focus
, and active
. All you need to do is list the CSS properties and values in the state object, and ctr
automatically configures the proper pseudo-class and the corresponding negation CSS pseudo-class (:not()
). It also configures the transition-property
, transition-duration
, transition-delay
, and transition-timing-function
for all CSS properties. Furthermore, ctr
provides similar abstractions for animation, elements such as before
and after
, as well as media queries, and much much more.
Finally, ctr
comes pre-packed with some of the best CSS libraries such as:
- Animate.css for animation presets
- LostGrid for a grid framework
- Responsive text for creating responsive type -
font-size
,line-height
, andletter-spacing
- Rupture for easy media queries
- Hover.css for state presets
- CSSgram for image preset filters
- Family.scss - :nth-child helpers
Status
As I've outlined over at ctr-lang.com and in the documentation, the code base is extended way past its means. That being said, the hope is that I'll be able to secure funding to embark on a rewrite from the ground up. At the same time, things are pretty solid, so it goes without saying I believe and hope it will be nothing but smooth sailing for you as well.
Bugs & Contributions
I'm on the fence as to how I want to handle bug and contributions, but I'll lay down my current thoughts. I initially had hoped to raise funding for a rewrite but that obviously was wishful thinking, although, not all is lost because the code base is workable up to a point. I'll gladly spend the time fixing bugs if they warrant the time. However, if it's a complex edge case I doubt I will spend the time. So if you think it warrants my time and yours by all accounts, please pull an issue.
Structure
For the time being, all ctr
assets reside under this repository, that is the, Stylus plugin, Less plugin, YAML API, and the JavaScript API. Hopefully, the rewrite will materialize, and if that's the case, I'll separate assets out to create a much cleaner structure.
/lib
-> Allz the magicctr-stylus.js
-> Stylus Plugin Logicctr-less.js
-> Less Plugin Logicctr-js.js
-> Js API class constructor/ctr-js-nodes
-> All Js methods for thectr-js.js
class/ctr-js-nodes
-> The actual logic behindctr
/dist
ctr.styl
-> The most important file, which is both embarrassing and impressive in its own right. This Stylus file contains two Stylus Functions that act as a janky templating solution to provide the proper syntactical structure. Along the lines of mustache but for CSS. Removing this file; thus the Stylus dependency is one of the main reasons for the rewrite.
__tests__
-> Allz the test, and it has it's ownREADME.md
Best, te