https://github.com/peteboere/css-crush

CSS preprocessor.
https://github.com/peteboere/css-crush

css preprocessor

Last synced: about 2 months ago
JSON representation

CSS preprocessor.

• Host: GitHub
• URL: https://github.com/peteboere/css-crush
• Owner: peteboere
• License: mit
• Created: 2010-09-20T09:08:38.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2023-08-10T15:12:37.000Z (about 1 year ago)
• Last Synced: 2024-07-23T22:54:47.245Z (about 2 months ago)
• Topics: css, preprocessor
• Language: PHP
• Homepage: http://the-echoplex.net/csscrush
• Size: 1.82 MB
• Stars: 536
• Watchers: 30
• Forks: 51
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
![CI](https://github.com/peteboere/css-crush/actions/workflows/php.yml/badge.svg)



A CSS preprocessor designed to enable a modern and uncluttered CSS workflow.

* Automatic vendor prefixing

* Variables

* Import inlining

* Nesting

* Functions (color manipulation, math, data-uris etc.)

* Rule inheritance (@extends)

* Mixins

* Minification

* Lightweight plugin system

* Source maps

See the [docs](http://the-echoplex.net/csscrush) for full details.

********************************

## Setup (PHP)

If you're using [Composer](http://getcomposer.org) you can use Crush in your project with the following line in your terminal:

```shell

composer require css-crush/css-crush:dev-master

```

If you're not using Composer yet just download the library into a convenient location and require the bootstrap file:

```php

```

## Basic usage (PHP)

```php

```

Compiles the CSS file and outputs the following link tag:

```html

```

There are several other [functions](http://the-echoplex.net/csscrush#api) for working with files and strings of CSS:

* `csscrush_file($file, $options)` - Returns a URL of the compiled file.

* `csscrush_string($css, $options)` - Compiles a raw string of css and returns the resulting css.

* `csscrush_inline($file, $options, $tag_attributes)` - Returns compiled css in an inline style tag.

There are a number of [options](http://the-echoplex.net/csscrush#api--options) available for tailoring the output, and a collection of bundled [plugins](http://the-echoplex.net/csscrush#plugins) that cover many workflow issues in contemporary CSS development.

********************************

## Setup (JS)

```shell

npm install csscrush

```

## Basic usage (JS)

```js

// All methods can take the standard options (camelCase) as the second argument.

const csscrush = require('csscrush');

// Compile. Returns promise.

csscrush.file('./styles.css', {sourceMap: true});

// Compile string of CSS. Returns promise.

csscrush.string('* {box-sizing: border-box;}');

// Compile and watch file. Returns event emitter (triggers 'data' on compile).

csscrush.watch('./styles.css');

```

********************************

## Contributing

If you think you've found a bug please create an [issue](https://github.com/peteboere/css-crush/issues) explaining the problem and expected result.

Likewise, if you'd like to request a feature please create an [issue](https://github.com/peteboere/css-crush/issues) with some explanation of the requested feature and use-cases.

[Pull requests](https://help.github.com/articles/using-pull-requests) are welcome, though please keep coding style consistent with the project (which is based on [PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)).

## Licence

MIT