Theme SCSS Compiler

Developer	Simon Mista
Version	v1.0.0
Active Installs	0 +
Requires / Tested	6.3 / 6.9.4
Last Updated	2026-05-16 9:38am GMT
Official Link	View Details →

Theme SCSS Compiler lets you manage multiple SCSS → CSS pairs in the active theme directly from the WordPress admin (Tools → Theme SCSS Compiler). It uses the bundled scssphp library — no Node.js, no build tools, no command line. SCSS is the modern Sass syntax (CSS-superset with braces and semicolons).

Features

• Multiple file pairs – configure as many SCSS → CSS pairs as your theme needs (paths relative to the active theme).
• Per-pair Context – each pair runs on either the Frontend (wp_enqueue_scripts) or the Admin (admin_enqueue_scripts).
• Per-file versioning – each pair has its own version. Bumps are applied automatically via the style_loader_src filter, so your theme files stay untouched.
• Smart change detection – the version only bumps when the compiled CSS content of that specific pair actually changed. No cache busting for files you didn’t touch.
• @import-aware auto-recompile – every SCSS partial (@import, @use, @forward) is tracked. Editing a partial alone triggers a recompile on the next admin page load — no need to touch the entry SCSS file.
• Compressed (production) or expanded (development) SCSS output.
• Auto-compile when an SCSS source (or any of its imports) changes or the CSS output is missing – no white layouts after a fresh deployment.
• Auto-enqueue – the plugin runs wp_enqueue_style() for every configured pair on its respective context. Skips files that are already registered, so it never duplicates output.
• Manual compile button with live AJAX feedback and persistent error display in the admin.
• Concurrent-compile lock – a transient-based mutex prevents two admins triggering compiles at the same time from corrupting the CSS output.
• Code-first configuration – every option (pairs, output style, auto-compile, auto-enqueue, bump version) can be defined as a PHP constant in wp-config.php, in your theme, or via your .env / Bedrock workflow.
• Admin-only access – every endpoint requires the manage_options capability by default. Filterable via tscsscompiler_capability if you need to grant access to a custom role.
• Modern codebase – PHP 8.1+, WCAG 2.1 AA compliant admin UI, fully translated to German out of the box.

Privacy / GDPR

This plugin makes no external HTTP requests, sets no cookies, runs no telemetry, and does not track users. All processing happens locally on your server. The bundled libraries (scssphp, league/uri, symfony/filesystem, PSR HTTP interfaces) are MIT licensed and GPL-compatible. Source code is included in the plugin’s vendor/ directory.