Tornado

A Clojure library designed to generate CSS using hiccup-like data structures with focus on simplicity.

The library is very new, but I will try to update it depending on how my time works out.

The Tornado library is not designed to work in ClojureScript yet, but I want to address it soon.

Usage

Lein-tornado

A hot-code reloading plugin for automatic compilation of Tornado stylesheets:

If you are familiar with garden, you should not have any problems with switching to Tornado.

Require a namespace tornado.core, where you have available everything useful in this library. Define some example CSS-hiccup like below and run it with a function "repl-css" to see the compiled CSS:

(require '[tornado.core :refer :all])
=> nil

(def styles
  [:#some-id {:width            (px 15)
              :color            :font-black
              :background-color (rgb 100 150 200)}])
=> #'user/styles

(repl-css styles)

#some-id {
    width: 15px;
    color: #1A1B1F;
    background-color: rgb(100, 150, 200);
}

=> nil

For compiling and saving the stylesheet, there is a function tornado.compiler/css, also referred in tornado.core:

;; First, you have to ensure that the path "resources/css" exists. In the plugin
;;  Lein-tornado, this is not a problem anymore, the library creates the folders for you.
(css {:output-to "resources/css/example.css"} styles)
=> nil

The complete documentation with examples will be under this link: https://orgpad.com/s/SjH_TDbx4PH

Plans for the future:

• Make it work in both Clojure and ClojureScript.
• Add html <... style="..."/> data generator.
• Docs to CSS functions, better docs overall.
• More common utility functions (currently only 'important' and 'grid-areas'.
• More at-rules functions (currently @media, @font-face, @keyframes).
• The code could be simpler on some places.
• More examples in the OrgPad document.

Contact

Although there are more ways to contact me, you can send me an e-mail to suran (dot) orgpad (at) gmail (dot) com. I will always try to reply as soon as possible. I am also on discord: Honza_Suran#6703

License

Copyright © 2021 Jan Šuráň

Distributed under the Eclipse Public License.