Deterministic Style Sheets
Switch branches/tags
Nothing to show
Clone or download
Latest commit 713739c Dec 8, 2018

README.md

screen shot 2018-07-08 at 5 45 52 pm

Deterministic Style Sheets

Build Status XO code style styled with prettier

DSS (Deterministic StyleSheets) is a component-oriented CSS authoring system that compiles to high-performance atomic CSS classes-based stylesheets.

DSS works like CSS Modules except that styles resolution is deterministic, CSS is compiled to atomic classes and the final bundle is very small.

Read more about how it works on the website.

[warning, this is an experimental project and might not be production ready]

The repo comes with examples:

cd examples/cli
# or cd examples/webpack
npm install
npm start

Features

  • ⚡️ Automatic compilation to Atomic CSS classes and high-performance stylesheets
  • 🆎 Deterministic styles resolution: styles are always resolved in application order
  • 📦 Scoped Styles
  • 🌎 Framework and language agnostic
  • 🤝 Preprocessors friendly
  • 💻 Standalone CLI and support for Webpack 3 and 4 with automatic vendor prefixing
  • ✂️ CSS the Best Parts

Contributing

DSS is developed as a monorepo thanks to lerna and yarn workspaces. Everything you need to know is in this repository.

Since this is a side project and I don't want to burn out, I decided to disable the GitHub issues.

Bugs

If you find a bug please submit a pull request with a failing test or a fix, and good description for the issue.

Features request

Please submit a pull request with an RFC where you explain the why and the how you think this feature is useful. I'd be glad to start a conversation from there before moving on to implementation. Also please let me know if you would be up to implement the feature you are suggesting.

My code is crap

I know, it is a side project and I didn't sweat the details. I am more than happy to discuss about a complete rewrite if the project becomes popular.

LICENSE

MIT