Skip to main content

Precompress Django static files with class names shortening.

Project description

Django Static class minifier


The class minifier package shortens the class name in the DOM to single character and reduces the file size. more about the algorithm in the upcoming blog post.

End result : Alt


$ pip install django-static-class-minifier

(you may want to write this in your requirements.txt)

In -

In Installed apps -

'static_compressor', #installed app

In Middleware -

'static_compressor.middleware.MinifyClassMiddleware', # Add this line, right after csrf middleware.

Make sure, you have set up path of static files and static root directory.

os.path.join(BASE_DIR, 'static'),

STATIC_ROOT = os.path.join(BASE_DIR, 'all_staticfiles')

Update the static files storage:

STATICFILES_STORAGE = 'static_compressor.staticfiles_storage.CompressedStaticFilesStorage'

Run the below command and make sure static_root folder is deleted before running the command.

$ python collectstatic_compress

When you run $ python collectstatic_compress it will have an additional post-processing pass to compress your static files and it creates data.json file which contains classes from all included css files and js files.

The class selectors which js files consider and change -


If your adding classes to the DOM based on http response or a common function which appends class to the dom, then consider excluding those files. Right now that's the limitation of this project. In the future, There might be a syntax to consider those classes.

Make sure that your web server is configured to serve precompressed static files:

  • If using nginx:
  • Caddy will serve .gz and .br without additional configuration.

Also, as Brotli is not supported by all browsers you should make sure that your reverse proxy/CDN honor the Vary header, and your web server set it to Vary: Accept-Encoding.

Available Storages

  • static_compress.CompressedStaticFilesStorage: Generate .br and .gz from your static files
  • static_compress.CompressedManifestStaticFilesStorage: Like ManifestStaticFilesStorage, but also generate compressed files for the hashed files
  • static_compress.CompressedCachedStaticFilesStorage: Like CachedStaticFilesStorage, but also generate compressed files for the hashed files You can also add support to your own backend by applying static_compressor.staticfiles_storage.CompressMixin to your class. By default it will only compress files ending with .js, .css and .svg. This is controlled by the settings below.


django-static-class-minifier settings and their default values:

EXCLUDE_STATIC_JS_FILES = [] # exclude js libraries from classnames minifier
MINIFY_CLASS_HTML = False # Change it to True in production environment
# By default, the admin files classes won't be minified.
STATIC_CLASSES_FILE_NAME = 'data.json' # It should be an json file

CLASS_SALT_VALUE = 'ascii_lowercase' # Choices - 'ascii_lowercase' or 'ascii_uppercase' or 'ascii_letters' or custom characters. The custom characters should not contain special characters and the length of salt should be greater then 8. Example : CLASS_SALT_VALUE = '_abcdefghijk123'.

# Incase, Inside your app if there is static directory then include it in STATIC_INCLUDE_DIRS

    os.path.join(BASE_DIR, 'faq/static'), # Example : Let the app name be faq

STATIC_COMPRESS_FILE_EXTS = ['js', 'css', 'svg']

Default values types and description -

Settings Type Description
EXCLUDE_STATIC_JS_FILES Array These js files will be excluded from classnames shortening, In other words the class names won't be changed.
EXCLUDE_STATIC_CSS_FILES Array Same as above but for css files.
EXCLUDE_STATIC_SVG_FILES Array Same as above but for svg files
EXCLUDE_STATIC_DIRECTORY Array The directory name in the array will be excluded from class names shortening.
EXCLUDE_URL_MINIFICATION Array The URL in the array will exclude from shortening of class names.
EXCLUDED_CLASSNAMES_FROM_MINIFYING Array The words in an array won't be shortened.
MINIFY_CLASS_HTML Boolean If its True it minifies class names in the HTML. Make sure there is JSON file or it will throws an error.
STATIC_CLASSES_FILE_NAME String The JSON file name. By default its data.json
STATIC_INCLUDE_DIRS Tuple Includes static directory inside the app.
CLASS_SALT_VALUE String Choices - 'ascii_lowercase' or 'ascii_uppercase' or 'ascii_letters' or custom characters. The custom characters should not contain special characters and the length of salt should be greater then 8. Example : CLASS_SALT_VALUE = '_abcdefghijk123'.


In case, If you want to Internal style or Internal load script in the HTML. Then consider using Django Inline Static package.

File size reduction

Original file - 100k style.css
compressed class minifier file - 70k style.css (30% reduction in file size)
(Note - reduction of the file depends on the number of class selectors used and the length of the class name.)
After brotli and Gzip compression - 40k style.css.gz (60% reduction in file size, in total), 35k (65% reduction in file size) 


I have merged the code with django-static-compress package to enable gzip and brotli compression. In case, if you just use brotli and gzip compression without using class minifier. You can use django-static-compress The author of django-static-compress Manatsawin Hanmongkolchai


Licensed under the MIT License

Happy coding! :)

Project details

Download files

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

Files for django-static-class-minifier, version 0.2.1
Filename, size & hash File type Python version Upload date
django_static_class_minifier-0.2.1-py3-none-any.whl (36.1 kB) View hashes Wheel py3
django-static-class-minifier-0.2.1.tar.gz (23.1 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page