Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Minifies and bundles JS and CSS files included with bowerstatic.

Project Description


Bundling and minifying components included via bowerstatic.

This recipe imports you bowerstatic components, which you must specify in the recipes config (see below for details). It then retrieves your local components, calculates the import order and minifies and bundles JS and CSS files. The bundles are saved to your bower_components folder (or whatever folder you specified) as a new component called bowerstatic_bundle.

In your application you can then switch between bundled or non-bundled versions with an include helper function:

def bower_include(environ, name):
    if not os.environ.get('BOWERSTATIC_DEBUG'):
        name = 'bowerstatic_bundle'
    include = components.includer(environ)

In your view, where you normally get the includer and include your libraries, you now call:

bower_include(self.request.environ, '<you_library_name>')

This package uses rcssmin and rjsmin to minify CSS and JS files.


Here is an example configuration for bowerstaticbundler:

parts += bundle

recipe = gocept.recipe.bowerstaticbundler
eggs = mypackage
modules = mypackage.browser.resource
bower = mypackage.bower
target_dir = ${config:bower_components}
environment = bundle-config

BOWER_COMPONENTS_DIR = ${config:bower_components}

You need to specify the location of your local components via the eggs and modules options. Eggs is needed to import your modules, where the components live, while modules specify the path to import them directly. This is needed as bower calculates the components and resources during import time, so we need to trigger them in the build step.

You also must provide the location of you bower singleton via the bower option.

target_dir specifies the directory, where the bundled component will be placed. It is recommended to point this to your bower_components folder, where your bower packages live, as bowerstatic will have to import the bundles as well in order to be able to include them into your Application.

With the environment option you can specify environment variables. In the example above we specify one environment variable called BOWER_COMPONENTS_DIR, which is the variable bower is looking for in the environment to get the installed bower packages. This might be different in your setup.


1.2.2 (2015-01-30)

  • Support for multiple local components.

1.2.1 (2015-01-14)

  • Also copy images into the bundle dir, which will be rendered as the fav icon.
  • Make generated .bower.json file more readable by adding newlines and indent.
  • When copying resources, create a separate directory for each package to reduce probability of name clashes.

1.2.0 (2015-01-13)

  • Copy all template files into the bundle dir, rather building one huge template

1.1.1 (2015-01-12)

  • Prevent error on update if bowerstatic_bundle directory is missing.

1.1 (2015-01-12)

  • Symlink additional resources references in CSS files (images, fonts, …) into the bundle and point minified CSS to these symlinks.

1.0.2 (2015-01-08)

  • Fixed handling of the pkg_resources working set when collecting resources from eggs.
  • Make sure recipe does not brake when there are no resources to bundle.

1.0.1 (2014-09-20)

  • Repair homepage url in

1.0.0 (2014-09-20)

  • Initial release.
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (14.6 kB) Copy SHA256 Checksum SHA256 Source Jan 30, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting