django-webpack-loader

What it is and what it does

Django Webpack Loader bridges Webpack and Django by consuming a stats file (webpack-stats.json) generated by webpack-bundle-tracker and exposing a template tag to render compiled bundles. It reads bundle metadata at runtime and injects the correct script and link tags into Django templates, handling asset paths and caching based on the DEBUG setting.

The package has no runtime dependencies and integrates directly into Django's template system. During development, it polls the stats file frequently to reflect live changes; in production, it caches the file once to minimize I/O. Configuration is done via Django settings, specifying the stats file location, bundle directory, and optional regex patterns to exclude certain assets.

Use it for

• Render CSS and JavaScript bundles compiled by Webpack into Django templates using a single template tag.
• Develop Django projects with hot-reloading frontend assets by polling the stats file during development.
• Cache bundle paths in production to avoid repeated stats file reads while serving pre-compiled assets.
• Exclude specific generated files (e.g., source maps, hot-update files) from template rendering via regex patterns.
• Integrate multiple Webpack entry points into different parts of a Django template for code splitting.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

django-webpack-loader on PyPI

Before you install

Low install friction with no runtime dependencies. Actively maintained with recent releases; supports modern Django (4.2–5.2) and Python (3.8–3.13) versions.

webpack-bundle-tracker must be configured in your Webpack build to generate the stats file before django-webpack-loader can read it.

License in practice

MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects.

Quickstart

# Install
pip install django-webpack-loader

# In Django settings.py
INSTALLED_APPS = [
    ...
    'webpack_loader',
]

WEBPACK_LOADER = {
    'DEFAULT': {
        'STATS_FILE': '/path/to/webpack-stats.json',
    }
}

# In a Django template
{% load render_bundle from webpack_loader %}
{% render_bundle 'main' 'css' %}

Package facts

Evidence: django_webpack_loader-3.2.4-py2.py3-none-any.whl

Tags

More Build Tools packages

See also django-navhelper · django-pipeline · django-components · django-tailwind · django-sass-processor · django-vite · django-jinja · django-template-partials · Flask-Assets · django-js-asset