This package is abandoned and no longer maintained. The author suggests using the kss-php/bridge-bundle package instead.

A Symfony2 implementation of KSS: a methodology for documenting CSS and generating styleguides

Installs: 4 162

Dependents: 0

Suggesters: 0

Stars: 10

Watchers: 4

Forks: 1

Open Issues: 1


v0.6.1 2014-08-02 02:26 UTC


This bundle provides a simple integration of the kss-php library into Symfony2. KSS is a methodology for documenting CSS and generating styleguides. You can find more information about KSS here at


The easiest way to install this bundle is through composer. In your Symfony2 project folder, type the following command:

$ composer require scan/kss-bundle

This will install the bundle and all dependencies needed for the bundle to work.

Next, you will need to enable the bundle by adding it to your Kernel:

// app/AppKernel.php

public function registerBundles()
    $bundles = array(
        // ...

        new Scan\Bundle\KssBundle\ScanKssBundle(),

Finally, if you'd like try out the example provided in the bundle, you'll need to add the following to your symfony2 routes.

# app/config/routing_dev.yml
    resource: @ScanKssBundle/Controller/
    type:     annotation
    prefix:   /_kssExample

Basic Usage

To output the dynamically generated styleguides, you'll need to create a \Scan\Kss\Parser in your controller and pass it the directory containing your stylesheets.


namespace Scan\Bundle\KssBundle\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
use Scan\Kss\Parser;

class ExampleController extends Controller
     * @Route("/styleguide")
     * @Template
    public function styleguideAction()
        $kss = new Parser($this->getRequest()->server->get('DOCUMENT_ROOT') . '/bundles/scankss/css');
        return array(
            'kss' => $kss,

Then in your views, when you want to output a styleguide section, use the following twig include:

{% include 'ScanKssBundle:Blocks:block.html.twig' with
        'section' : kss.getSection('Buttons - Stars')

Finally, you'll need to include a small JavaScript file to help rendering of pseudo-classes such as :hover, :disabled, etc. in the styleguide. This can be done with the following lines somewhere in your layout or view:

{% javascripts '@ScanKssBundle/Resources/public/js/*' %}
    <script src="{{ asset_url }}"></script>
{% endjavascripts %}

If you would like, you can either create your own styles for the block or use the styles included. To use the styles included, add the following to your layout or view:

{% stylesheets 'bundles/scankss/css/*' %}
    <link rel="stylesheet" href="{{ asset_url }}" />
{% endstylesheets %}

For a complete example, take a look at the included example controllers, views, and stylesheets.