PHPackages                             asoc/compassomator-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. asoc/compassomator-bundle

AbandonedArchivedSymfony-bundle[Utility & Helpers](/categories/utility)

asoc/compassomator-bundle
=========================

Simplifies Compass/SASS development with Symfony2 bundles

0.2.1(12y ago)15.2k[1 issues](https://github.com/AStateOfCode/CompassomatorBundle/issues)MITPHP

Since Dec 23Pushed 12y ago1 watchersCompare

[ Source](https://github.com/AStateOfCode/CompassomatorBundle)[ Packagist](https://packagist.org/packages/asoc/compassomator-bundle)[ Docs](https://github.com/AStateOfCode/CompassomatorBundle)[ RSS](/packages/asoc-compassomator-bundle/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

The Compassomator
=================

[](#the-compassomator)

A bundle to simplify the development with Compass/SASS and symfony2 bundles. It is intended to be used in conjunction with Assetic and not as a replacement. In addition, it adds a file importer to SASS that is able to resolve the familiar **@BundleName** notation and also the SASS script function **bundle-public('@BundleName/images/foo.png')** to build the correct path to any asset in the bundles public directory.

The Idea
========

[](#the-idea)

Use compass to manage every bundle as a standalone project and use a special file importer to reference assets in other bundles. The generated CSS files are then referenced in Assetic.

Requirements
============

[](#requirements)

Any Symfony2 2.3+ application will do. You will also need Ruby with rubygems installed and the following gems:

```
gem install json
gem install compass
```

Installation
============

[](#installation)

```
composer require asoc/compassomator-bundle
```

Configuration
=============

[](#configuration)

The Compassomator is also able to trigger *assetic:dump* and *assetic:dump --watch* if it is desired. To enable it, set the following option:

```
asoc_compassomator:
	manage_assetic: true
```

Quick Setup
===========

[](#quick-setup)

Step 1
------

[](#step-1)

Create a simple config.rb file inside every bundle inside the **Resources/** directory with the following content:

```
css_dir = "public/css"
sass_dir = "sass"
```

Any generated CSS file will be placed inside the bundles **Resources/public/css** directory, every SCSS/SASS file that should be compiled by Compass will be searched in *Resources/sass*.

Step 2
------

[](#step-2)

Add the **Resources/public/css** to **.gitignore** in the project root. In this setup it is assumed that there are *NO* css files in the public/css directory that are not generated by Compass/SASS. If there are, it might be required to choose another *css\_dir*.

Step 3
------

[](#step-3)

Reference the generated CSS files with the usual Assetic helper in the view:

```
{% stylesheets
'@BundleName/Resources/public/css/foo.css'
'@BundleName/Resources/public/css/bar.css'
%}
...
{% endstylesheets %}
```

Step 4
------

[](#step-4)

Run the compassomator.

```
app/console compassomator:compile
```

If assetic is not run automatically (manage\_assetic: true), dumping the assets with assetic is also required:

```
app/console assetic:dump
```

Step 5
------

[](#step-5)

Run compass watch and assetic dump in the background to automatically update the generated CSS.

```
# Start
app/console compassomator:watch
# End
app/console compassomator:watch --abort
```

If assetic is not run automatically (manage\_assetic: true), watching the assets with assetic is also required:

```
app/console assetic:dump --watch
```

Step 6
------

[](#step-6)

Show logs

To view any errors, compass or assetic, the logs can be shown using the logs command.

```
app/console compassomator:logs
```

Logs and other run files can be found in **app/cache/compassomator** for debugging purposes.

Thanks
======

[](#thanks)

Made possible by [BITE GmbH](https://www.b-ite.de) as a side project during my master thesis.

Notes
=====

[](#notes)

- At the moment, cache:clear will trigger the compassomator:compile command once, so it will take a few seconds longer on a cache:clear by default.

Contribution
============

[](#contribution)

Whatever is on your mind, open an issue or a pull request (be it a bug/typo/feature request/code improvement...) :)

License
=======

[](#license)

MIT

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Total

4

Last Release

4493d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/98b7d41119ffd00cfc817eb050fd5965989014f60c08d52dbee29098c3cc9acf?d=identicon)[padakuro](/maintainers/padakuro)

---

Top Contributors

[![padakuro](https://avatars.githubusercontent.com/u/2874813?v=4)](https://github.com/padakuro "padakuro (24 commits)")[![hanneskaeufler](https://avatars.githubusercontent.com/u/68024?v=4)](https://github.com/hanneskaeufler "hanneskaeufler (3 commits)")[![StefanHaeck](https://avatars.githubusercontent.com/u/1077792?v=4)](https://github.com/StefanHaeck "StefanHaeck (1 commits)")

---

Tags

sassscsscompass

### Embed Badge

![Health badge](/badges/asoc-compassomator-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/asoc-compassomator-bundle/health.svg)](https://phpackages.com/packages/asoc-compassomator-bundle)
```

###  Alternatives

[scssphp/scssphp

scssphp is a compiler for SCSS written in PHP.

62827.7M220](/packages/scssphp-scssphp)[nizsheanez/yii2-asset-converter

Less, Sass, Scss and Phamlp converter for Yii2. No system requires. yii2-composer support, Less autoupdate, customizing of output directory

64167.5k6](/packages/nizsheanez-yii2-asset-converter)[ssnepenthe/color-utils

A PHP library for performing SASS-like color manipulations.

631.1M10](/packages/ssnepenthe-color-utils)[panique/laravel-sass

Compiles your Sass .scss files to .css every time you run your app (in development)

73171.8k1](/packages/panique-laravel-sass)[efficiently/larasset

Larasset is a library for Laravel 5 which manage assets in an easy way.

684.8k](/packages/efficiently-larasset)[trentrichardson/cakephp-shrink

Compiles, combines, and minifies javascript, coffee, less, scss, and css

1619.3k](/packages/trentrichardson-cakephp-shrink)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)