Theme SCSS Compiler

Compile SCSS (Sass) to CSS straight from the WordPress admin. Theme SCSS Compiler manages as many SCSS → CSS file pairs as your theme needs, under Tools → Theme SCSS Compiler. It uses the bundled scssphp library, so there is no Node.js, no build step and no command line. SCSS is the modern Sass syntax: plain CSS plus nesting, variables and @import.

Features

• Multiple file pairs – as many SCSS → CSS pairs as your theme needs, paths relative to the active theme.
• Frontend or Admin per pair – each pair enqueues on wp_enqueue_scripts or admin_enqueue_scripts.
• Per-file versioning – every pair has its own version, applied through the style_loader_src filter. Your theme files stay untouched.
• Smart change detection – a version only bumps when that pair’s compiled CSS really changed.
• @import-aware recompile – every partial (@import, @use, @forward) is tracked. Edit a partial and the next admin page load recompiles.
• Compressed or expanded output – minified for production, readable for development.
• Auto-compile – missing or stale CSS is rebuilt on the next admin page load, so a deploy never leaves you with unstyled pages.
• Auto-enqueue – the plugin calls wp_enqueue_style() for each pair and skips files already registered, so output is never duplicated.
• Manual compile button – one click, live feedback, persistent error display.
• Concurrent-compile lock – two admins compiling at once can’t corrupt the CSS.
• Code-first config – set every option as a PHP constant in wp-config.php, your theme, or .env / Bedrock.
• Admin-only – every endpoint needs manage_options. Change that with the tscsscompiler_capability filter.
• Modern and accessible – PHP 8.1+, WCAG 2.1 AA admin UI, German translation included.

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; their source is included in the plugin’s vendor/ directory.