django-sass-processor

What it is and what it does

django-sass-processor is a Django app that compiles SASS/SCSS files into CSS during template rendering, without requiring external build tools, file watchers, or IDE plugins. It provides a templatetag `sass_src` that works in both Django and Jinja2 templates, and can also be used directly in Python code via the Media class for forms and admin. The processor caches compiled output and only recompiles when source files are modified, making it suitable for development workflows.

The package supports configuration through Django settings for include paths, compiler precision, and output style. It can also generate sourcemaps for easier debugging. For production, SCSS files can be precompiled offline using a management command, eliminating the need for a compiler in the deployed environment. The app automatically discovers SCSS partials in installed Django apps' static folders, reducing boilerplate configuration.

Use it for:

• Develop Django projects with SCSS without running a separate daemon or build tool.
• Reference SCSS files directly in templates and have them compile to CSS on demand during development.
• Configure SASS variables and paths in Django settings.py instead of maintaining separate SCSS configuration files.
• Debug stylesheet errors directly in Django's development server console with sourcemaps.
• Precompile SCSS offline and deploy only CSS to production, avoiding compiler as a runtime dependency.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Compiles SASS/SCSS files to CSS on the fly during Django template rendering, eliminating the need for external build tools or file watchers.

Yes. The package is actively maintained, has no runtime dependencies, supports current Django versions (3.2 through 5.2) and Python versions (3.8 through 3.13), carries no known vulnerabilities, and solves a real friction point in Django development. Install it if you use SCSS in templates and want to avoid external build-tool overhead; skip it only if your project already has a mature build pipeline in place.

Install

django-sass-processor on PyPI

pip install django-sass-processor

uv add django-sass-processor

poetry add django-sass-processor

Installing django-sass-processor

Before you install

Low friction install with no runtime dependencies. Active maintenance since 2015, last commit 2026-03-09, and supports Django 3.2, 4.2, 5.0, 5.1, 5.2 and Python 3.8, 3.9, 3.10, 3.11, 3.12, 3.13.

License in practice

MIT license permits permissive use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install django-sass-processor

# In settings.py
INSTALLED_APPS = ['sass_processor', ...]
STATICFILES_FINDERS = [
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
    'sass_processor.finders.CssFinder',
]

# In template
{% load sass_tags %}
<link rel="stylesheet" href="{% sass_src 'path/to/file.scss' %}">

A SASS compiler is required during development; offline compilation via manage.py compilescss is available for production deployment.

Verify before relying

• Whether a system SASS compiler must be installed separately or is bundled with the package.
• Performance characteristics when compiling large or deeply nested SCSS file hierarchies with many imports.
• Whether django-compressor is required for offline compilation or only optional.

Package facts

Evidence: django_sass_processor-1.4.2-py3-none-any.whl

Keywords: django, sass

Tags

More Dynamic Content packages