unbloat

Atomic CSS in JS

What

To prevent CSS file from bloating.

It's like Atomic CSS, but you don't have to remember all the complex syntax.

Feature

Styled-component like syntax, well supported by editors
Can be used in server side (Python, Ruby, Go, etc), as long as it can parse JSON
Zero runtime - build to static CSS file

Installation

yarn add "https://github.com/jas-chen/unbloat#0.0.6"

Setup

Create a file unbloat.jest.config.js under the project root

const path = require('path');
const unbloat = require('unbloat');

const config = unbloat({
  dest: path.join(__dirname, 'build'),
});

module.exports = config;

Add a script in the package.json

"scripts": {
  "unbloat": "jest --config=unbloat.jest.config.js"
},

Ignore generated files in .gitignore

src/style.css
*.css.json

yarn unbloat
# Or
yarn unbloat --watch

Build

NODE_ENV=production yarn unbloat

Example

Basic

Input

src/button.css.json.js

test(__filename, async () => {
  await css`
    .default {
      cursor: pointer;
      color: #333;
      background-color: #fff;
    }

    .primary {
      cursor: pointer;
      color: #fff;
      background-color: #007bff;
    }
  `;
});

Output

src/button.css.json

{
  "default": "c-38eafc58 c-bd0ecde9 c-c0ae8c5b",
  "primary": "c-38eafc58 c-cf9884e5 c-0c288c7c"
}

build/style.css

.c-0c288c7c{background-color:#007bff}.c-38eafc58{cursor:pointer}.c-bd0ecde9{color:#333}.c-c0ae8c5b{background-color:#fff}.c-cf9884e5{color:#fff}

With variavbles

src/button.css.json.js

const PRIMARY_COLOR = '#007bff';

test(__filename, async () => {
  await css`
    .primary {
      cursor: pointer;
      color: #fff;
      background-color: ${PRIMARY_COLOR};
      text-align: center;
      user-select: none;
      border: 1px solid ${PRIMARY_COLOR};
      padding: .375rem .75rem;
      border-radius: .25rem;
      transition:
        color .15s ease-in-out,
        background-color .15s ease-in-out,
        border-color .15s ease-in-out;

      &:hover {
        background-color: #0069d9;
        border-color: #0062cc;
      }

      @media (min-width: 501px) {
        display: inline-block;
      }

      @media (max-width: 500px) {
        display: block;
      }
    }
  `;
});

Inspiration

License

MIT