PHPackages                             oveleon/contao-theme-compiler-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. oveleon/contao-theme-compiler-bundle

ActiveContao-bundle[Utility & Helpers](/categories/utility)

oveleon/contao-theme-compiler-bundle
====================================

Theme-Compiler for Theme-Manager Bundles

1.11.2(6mo ago)44.9k12MITPHPPHP ^8.1

Since Nov 25Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/oveleon/contao-theme-compiler-bundle)[ Packagist](https://packagist.org/packages/oveleon/contao-theme-compiler-bundle)[ Docs](https://www.oveleon.de/)[ RSS](/packages/oveleon-contao-theme-compiler-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (17)Versions (32)Used By (2)

Theme-Compiler
==============

[](#theme-compiler)

The contao theme compiler bundle adds the functionality to compile selected scss files within your theme settings.

- [Features](#features)
- [How to install](#how-to-install-the-package)
- [Initial setup](#initial-setup)
- [Console commands](#console-commands)
- [Miscellaneous](#miscellaneous)

Features
--------

[](#features)

- Compiles your scss files in your contao installation
- A compile button next to your themes
- Able to add multiple source files
- Able to compile multiple files into one
- Enable backups for your compiled scss

How to install the package
--------------------------

[](#how-to-install-the-package)

#### Via composer

[](#via-composer)

```
composer require oveleon/contao-theme-compiler-bundle

```

#### Via contao-manager

[](#via-contao-manager)

```
Search for contao theme compiler bundle and add it to your extensions.

```

Initial setup
-------------

[](#initial-setup)

1. Create a theme and add source file/s in your theme settings
2. Add a destination folder for your source files
3. (Optional settings for combining your files and more)
4. Save

    [![Admin View: Advanced form overview](https://camo.githubusercontent.com/1dd78e849f53a3b8beb0b630be4790b1669f97367703ec9b793b919dbccb9085/68747470733a2f2f7777772e6f76656c656f6e2e64652f73686172652f6769746875622d6173736574732f636f6e74616f2d7468656d652d636f6d70696c65722d62756e646c652f7468656d6553657474696e67732e6a7067)](https://camo.githubusercontent.com/1dd78e849f53a3b8beb0b630be4790b1669f97367703ec9b793b919dbccb9085/68747470733a2f2f7777772e6f76656c656f6e2e64652f73686172652f6769746875622d6173736574732f636f6e74616f2d7468656d652d636f6d70696c65722d62756e646c652f7468656d6553657474696e67732e6a7067)
5. Compile in your theme-settings, within your theme overview, under maintenance or via console command

    [![Admin View: Advanced form overview](https://camo.githubusercontent.com/09dfc62971f62caadeb5e661cd3dcb1f2209d397e9d99c41b758aa77013bf9af/68747470733a2f2f7777772e6f76656c656f6e2e64652f73686172652f6769746875622d6173736574732f636f6e74616f2d7468656d652d636f6d70696c65722d62756e646c652f7468656d654f766572766965772e6a7067)](https://camo.githubusercontent.com/09dfc62971f62caadeb5e661cd3dcb1f2209d397e9d99c41b758aa77013bf9af/68747470733a2f2f7777772e6f76656c656f6e2e64652f73686172652f6769746875622d6173736574732f636f6e74616f2d7468656d652d636f6d70696c65722d62756e646c652f7468656d654f766572766965772e6a7067)[![Admin View: Advanced form overview](https://camo.githubusercontent.com/dfa27f7670ea21e33f44e75eb0c6844bf684319961179d30dde9d47e0c1f6d18/68747470733a2f2f7777772e6f76656c656f6e2e64652f73686172652f6769746875622d6173736574732f636f6e74616f2d7468656d652d636f6d70696c65722d62756e646c652f6d61696e74656e616e636553657474696e67732e6a7067)](https://camo.githubusercontent.com/dfa27f7670ea21e33f44e75eb0c6844bf684319961179d30dde9d47e0c1f6d18/68747470733a2f2f7777772e6f76656c656f6e2e64652f73686172652f6769746875622d6173736574732f636f6e74616f2d7468656d652d636f6d70696c65722d62756e646c652f6d61696e74656e616e636553657474696e67732e6a7067)

    ```
    php vendor/bin/contao-console contao:themecompiler:compile [id]

    ```

Console commands
----------------

[](#console-commands)

### List themes

[](#list-themes)

- Outputs a list of your themes within `tl_theme`

```
php vendor/bin/contao-console contao:themecompiler:list

```

### Compile theme

[](#compile-theme)

- Compiles a theme (\[id\] is mandatory):

```
php vendor/bin/contao-console contao:themecompiler:compile [id]

```

Miscellaneous
-------------

[](#miscellaneous)

### Enable file sync on every compilation

[](#enable-file-sync-on-every-compilation)

Version 1.8 has been rewritten to skip the DBAFS sync if the files already exist. This saves a database call and logic for each output file and improves compilation time.

To enable the old behaviour, use following in your config.yaml

```
# config/config.yml
contao_theme_compiler:
  file_sync: true
```

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance70

Regular maintenance activity

Popularity26

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 72.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~71 days

Recently: every ~99 days

Total

31

Last Release

205d ago

Major Versions

0.1.3 → 1.0.02020-03-04

PHP version history (4 changes)0.1.0PHP ^5.6 || ^7.0

1.1.1PHP ^7.0 || ^8.0

1.2.0PHP ^8.0

1.5.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/acb45ab67207e71f4495c84d405e09a9de7ea11f7645c3de802d9abb3691efa0?d=identicon)[oveleon](/maintainers/oveleon)

![](https://www.gravatar.com/avatar/b01df75d47aa595ed295e64cfde15e5f17ea7b07458b71429ce40804c081d0a6?d=identicon)[Doi](/maintainers/Doi)

---

Top Contributors

[![zoglo](https://avatars.githubusercontent.com/u/55794780?v=4)](https://github.com/zoglo "zoglo (43 commits)")[![doishub](https://avatars.githubusercontent.com/u/48379929?v=4)](https://github.com/doishub "doishub (16 commits)")

---

Tags

compilercontaocontao-bundlethemecompilercontao

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/oveleon-contao-theme-compiler-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/oveleon-contao-theme-compiler-bundle/health.svg)](https://phpackages.com/packages/oveleon-contao-theme-compiler-bundle)
```

###  Alternatives

[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3183.3k6](/packages/codefog-contao-news-categories)[netgen/layouts-core

Netgen Layouts enables you to build and manage complex web pages in a simpler way and with less coding. This is the core of Netgen Layouts, its heart and soul.

3689.4k10](/packages/netgen-layouts-core)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)