Forces clients to reload static contents. (.js, .css, img)
Python Shell
Switch branches/tags
Nothing to show
Clone or download
Val Neekman
Val Neekman update readme
Latest commit a91a918 Sep 2, 2015
Failed to load latest commit information.
freshly update version and readme Sep 2, 2015
.gitignore update version and readme Sep 2, 2015
.travis.yml update travis Sep 2, 2015 update readme Sep 2, 2015 rework Sep 2, 2015 rework Sep 2, 2015
requirements.txt rework Sep 2, 2015 pep8 Sep 2, 2015

Django Freshly

A Django application that enables your server to remotely trigger a client-side asset reload

status-image version-image coverage-image download-image


A simple trigger of client-side asset reload.

How to install

1. easy_install django-freshly
2. pip install django-freshly
3. git clone
    a. cd django-freshly
    b. run python
4. wget
    a. unzip the downloaded file
    b. cd into django-freshly-* directory
    c. run python

How to use (production)

Install django-freshly using one of the methods outlined in the How to install section.

 # Add `freshly` to your `INSTALLED_APP`.

 # Add `freshly.middleware.assets.AssetVersioningMiddleware` to your `MIDDLEWARE_CLASSES`.
 # Note: ensure the middleware is the last item in your `MIDDLEWARE_CLASSES`.

 # Optional: overwrite the extensions list as per your requirements.
     'jpg', 'jpeg', 'gif', 'css', 'png', 'js', 'ico', 'txt'

 # Add `FRESHLY_ASSETS_VERSION` to your setting file.


 # OR


 # Up the version and restart Django to force clients to reload your website assets.

How to use (development):

Add FRESHLY_ASSETS_ALWAYS_FRESH to your settings file.

 # Set it to True to force a fresh copy of your assets on to the browsers.

 # Note: Do not use in production.

 # OR



The application is a perfect tool for the front-end designers during development.

Running the tests

To run the tests against the current environment:

python test


Released under a (BSD) license.


X.Y.Z Version

`MAJOR` version -- when you make incompatible API changes,
`MINOR` version -- when you add functionality in a backwards-compatible manner, and
`PATCH` version -- when you make backwards-compatible bug fixes.