PHPackages                             contao-thememanager/core - 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 &amp; Helpers](/categories/utility)
4. /
5. contao-thememanager/core

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

contao-thememanager/core
========================

Contao Theme-Manager

2.4.3(8mo ago)65.7k↑16.7%512AGPL-3.0-or-laterPHPPHP ^8.3CI failing

Since Nov 26Pushed 1mo ago4 watchersCompare

[ Source](https://github.com/contao-thememanager/core)[ Packagist](https://packagist.org/packages/contao-thememanager/core)[ Docs](https://www.contao-thememanager.com/)[ GitHub Sponsors](https://github.com/oveleon)[ RSS](/packages/contao-thememanager-core/feed)WikiDiscussions 2.x Synced 3w ago

READMEChangelog (10)Dependencies (20)Versions (102)Used By (12)

    ![ContaoThemeManager](/assets/markdown/logo_v_light.svg)

 [![](https://camo.githubusercontent.com/8d77c782b143958e94a77a4312dad7dc913d454c2830f8411c7253f4bcfd4efa/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73706f6e736f72732f6f76656c656f6e3f6c6162656c3d53706f6e736f72266c6f676f3d47697448756226636f6c6f723d253233666538653836)](https://github.com/sponsors/oveleon)

*Contao ThemeManager: A lightweight forward-thinking CSS component-first-framework leveraging flexbox and custom properties*

 [![](https://camo.githubusercontent.com/5c3b2332a320ca642fccce723c9ac324af6a32e99622d5a3bf7cd96d1defc1c1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f636f6e74616f2d7468656d656d616e616765722f636f72653f636f6c6f723d656639383338)](https://github.com/contao-thememanager/core) [![](https://camo.githubusercontent.com/856afaa40787d35a9ed6c143fbb4454bd6e61bf79aa0329450d3dbbec75fc83c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636f6e74616f2d7468656d656d616e616765722f636f72653f636f6c6f723d656639383338)](https://github.com/contao-thememanager/core) [![Oveleon](https://camo.githubusercontent.com/73ac9824b7cef8fbb58cdbc3087430da4b7754e6043b6028df26b2c5bab48496/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f76656c656f6e2d6d61696e7461696e65642d6566393833383f6c6f676f3d646174613a696d6167652f706e673b6261736536342c6956424f5277304b47676f414141414e535568455567414141424d4141414155434159414141427656515a3041414141475852465748525462325a30643246795a5142425a4739695a53424a6257466e5a564a6c5957523563636c6c50414141412f7870564668305745314d4f6d4e76625335685a4739695a53353462584141414141414144772f654842685932746c644342695a576470626a30693737752f496942705a443069567a564e4d4531775132566f61556836636d5654656b355559337072597a6c6b496a382b494478344f6e68746347316c6447456765473173626e4d366544306959575276596d5536626e4d366257563059533869494867366547317764477339496b466b62324a6c4946684e5543424462334a6c494455754e69316a4d545131494463354c6a45324d7a51354f5377674d6a41784f4338774f4338784d7930784e6a6f304d446f794d6941674943416749434167496a346750484a6b5a6a70535245596765473173626e4d36636d526d50534a6f644852774f693876643364334c6e637a4c6d39795a7938784f546b354c7a41794c7a49794c584a6b5a69317a6557353059586774626e4d6a496a346750484a6b5a6a70455a584e6a636d6c7764476c76626942795a47593659574a76645851394969496765473173626e4d366547317754553039496d6830644841364c793975637935685a4739695a53356a62323076654746774c7a45754d43397462533869494868746247357a4f6e4e30556d566d50534a6f644852774f693876626e4d7559575276596d5575593239744c336868634338784c6a41766331523563475576556d567a62335679593256535a57596a4969423462577875637a703462584139496d6830644841364c793975637935685a4739695a53356a62323076654746774c7a45754d433869494868746247357a4f6d526a50534a6f644852774f6938766348567962433576636d63765a474d765a57786c6257567564484d764d5334784c794967654731775455303654334a705a326c755957784562324e316257567564456c4550534a3164576c6b4f6a56454d6a41344f5449304f544e43526b52434d5445354d5452424f4455354d45517a4d5455774f454d34496942346258424e5454704562324e316257567564456c4550534a34625841755a476c6b4f6a4d354d6a5a424e6a517a4d7a5a46516a4578525546424d546442516b4e46515441784e6a673252444934496942346258424e5454704a626e4e305957356a5a556c4550534a346258417561576c6b4f6a4d354d6a5a424e6a51794d7a5a46516a4578525546424d546442516b4e46515441784e6a673252444934496942346258413651334a6c59585276636c527662327739496b466b62324a6c49456c736248567a64484a686447397949454e544e69416f56326c755a47393363796b695069413865473177545530365247567961585a6c5a455a7962323067633352535a5759366157357a644746755932564a52443069645856705a44706c4d44686b5a44686d5a43316d4f5441344c545135597a497459574d775a4330304f474533595449344f4463325957456949484e30556d566d4f6d5276593356745a57353053555139496e68746343356b615751364f544132524468474f454e4552555178525467784d5467794d6a56424d7a424751304e424e6a4534525551694c7a34675047526a4f6e52706447786c50694138636d526d4f6b46736444346750484a6b5a6a70736153423462577736624746755a7a30696543316b5a575a6864577830496a354d62326476583239325a57786c62323566576d56705932686c626c3979656a7776636d526d4f6d7870506941384c334a6b5a6a70426248512b494477765a474d3664476c306247552b49447776636d526d4f6b526c63324e796158423061573975506941384c334a6b5a6a70535245592b4944777665447034625842745a585268506941385033687759574e725a5851675a57356b50534a79496a382b50386942545141414162464a52454655654e71553038737252464563422f42726f6d4747614a52484b5349615966496d374a52537376484979754d2f774d6f724e654566554d714b6e624b77553254427770535553575957466d5342444b576d57636777635832507672633548586675584c2f367a443250337a32507565646f75713572696c4734304a50784175556d655838347447546b7779587367684f5759516d4b6f46617a45787a5644584649674565617a6350563954436e7a47706c5269484d6c374b674357596768793976514161734d45666b54715161724a394a46577730596c684a4676327255763874644b694468546962306569485179684f73523278796a6c70304246354d42454c647236576f68452b2b58367261424f7a36507757436669434f4c7a444e38735247494359796664726742413851326b6d666e7a514a697267686c772b585a414e55513571466d4859353252392f396c5743586a4270625250636175624468744873526f4f754e317265414f2f31482f50707a666461717267677a4f4c4b37594644367a504d71654c396174306777575a754b61306933686b755a6631453674746571455a6e6d4352625a56777850494f6e335638336c6974616f677a6272507568444f497762795564387138536176424f706c30726e78524f61644675676b46566f4f4a417831683472524a7677396532623975334143725939454e415a61442f4c2f45306169484d626266516333763762467857416368717074484141714e334851724d304a637358466f687a7a65785750596b354e2b424267416978355679767a525a627741414141415355564f524b35435949493d)](https://www.oveleon.de) [![](https://camo.githubusercontent.com/8e4edf0027ddb82e2cc0206669003648ff17edd72f5df0bb59707136946a3a2a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f6e74616f2d7468656d656d616e616765722f636f72653f636f6c6f723d353961313932)](https://packagist.org/packages/contao-thememanager/core) [![](https://camo.githubusercontent.com/8558045d6d6579a5f12421aa1255c1a80ad53264ed6217eef90dc04b153ea92c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f636f6e74616f2d7468656d656d616e616765722f636f72652f7068703f636f6c6f723d353961313932)](https://packagist.org/packages/contao-thememanager/core)

[**Read the Docs**](https://docs.contao-thememanager.com "Contao ThemeManager Documentation")

---

Support
-------

[](#support)

If you like this extension, we'd love your support in keeping the open-source spirit alive.

If you think this plugin is useful, please consider [sponsoring us](https://github.com/sponsors/oveleon) to help contribute to our time invested and to further development of this and other open source projects.

Your contributions, whether through `coding`, `testing`, `providing feedback`, or even a [donation](https://github.com/sponsors/oveleon), help ensure that we can continue offering free open source software. Join us in making a difference, and thank you for your support! - [Oveleon](https://www.oveleon.de).

[![](https://camo.githubusercontent.com/d2432db86e1cfca636933728a664bf886cff501efab549a0af6abab26fe8851b/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d53706f6e736f72266d6573736167653d254532253944254134266c6f676f3d47697448756226636f6c6f723d253233666538653836)](https://github.com/sponsors/oveleon)

---

> Working with **Contao 4.13** and **Contao ^5.3** (PHP ^8.1)

---

About
-----

[](#about)

Built with a focus on customization, efficiency, and adherence to industry best practices, the Contao ThemeManager offers a fully configurable system eliminating the need for knowing or writing CSS. Features include an integrated scssphp-based asset compiler, CSS versioning, dynamic CSS background image generation, icon font management, an array of new content elements and much more.

With comprehensive customization options via the backend, it's the technical cornerstone for crafting modern, responsive web experiences with Contao.

Table of contents
-----------------

[](#table-of-contents)

- [Features](#features)
- [Tools](#tools)
- [Installation](#installation)
- [Documentation](#documentation)
- [Bugs and feature requests](#bugs-and-feature-requests)
- [Extensions / Addons](#extensions--addons)
- [Further links](#further-links)
- [License](#license)
- [Sponsoring](#sponsoring)

Features
--------

[](#features)

- Lightweight (~55.8 kB (minified), ~11.4 kB (gzipped))
- Grid-System (based on [Flexbox](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes))
- Working with Contao 4.13 and Contao ^5.3
- In-built SCSS and asset compiler (based on [scssphp](https://github.com/scssphp/scssphp/))
- Fully customizable CSS framework configuration in the Contao Backend
- Default styles and layout for almost every Contao component
- Fully customizable contao components using the [Contao Component StyleManager](https://github.com/oveleon/contao-component-style-manager)
- Extended Headline configuration
- Enhancing Contao standard components (Table, gallery, news and more)
- New content elements (wrappers, text- / image- / icon- / list-components)
- Create CSS backgrounds within the filesystem
- Changing and integrating icon-fonts easily
- Dynamically generated StyleManager options
- *and more ...*

Tools
-----

[](#tools)

- Backend configuration for SCSS-variables [🔗](https://github.com/oveleon/contao-config-driver-bundle)
- Asset-Compiler for generating and renewing CSS-Files from the theme configuration [🔗](https://github.com/oveleon/contao-theme-compiler-bundle)
- Styles and component configuration using the StyleManager [🔗](https://github.com/oveleon/contao-component-style-manager)
- Custom scss-file integration to customize whole websites using this framework

Installation
------------

[](#installation)

#### Upgrading to version 2

[](#upgrading-to-version-2)

> An upgrade from Contao ThemeManager v1.\* to v2.\* is **not recommended**

#### Via composer

[](#via-composer)

```
composer require contao-thememanager/core

```

#### Via contao-manager

[](#via-contao-manager)

```
Search for 'Contao ThemeManager Core' and add it to your extensions.

```

After installing the Contao ThemeManager Core, you need to run the pending schema updates.

Documentation
-------------

[](#documentation)

A german documentation (WIP - work in progress) can be found by using the following link: [**Documentation** ](https://docs.contao-thememanager.com "Documentation")

Bugs and feature requests
-------------------------

[](#bugs-and-feature-requests)

We appreciate your contributions when opening issues or requesting features. To help keep our issue list tidy, we may need to close issues if questions go unanswered.

### Bugs

[](#bugs)

If you think you have found a bug please follow these guidelines

1. Search for existing issues and check if your problem has already been reported
2. Check if you are using the latest version and if the issue has been fixed already
3. Provide a step-by-step tutorial on how to reproduce the issue in an isolated environment using only the Contao ThemeManager Core

### Feature requests

[](#feature-requests)

Feature requests are welcome. But take a moment to find out whether your idea fits with the scope and aims of the project. It's up to you to make a strong case to convince the project's developers of the merits of this feature. Please provide as much detail and context as possible.

Extensions / Addons
-------------------

[](#extensions--addons)

- Slider (Tiny Slider) [🔗](https://github.com/contao-thememanager/ctm-tiny-slider)
- Recommendation (Contao Recommendation) [🔗](https://github.com/contao-thememanager/ctm-recommendation)
- ...

Further Links
-------------

[](#further-links)

- [Documentation](https://docs.contao-thememanager.com)

License
-------

[](#license)

This project is licensed under the AGPL-3.0 License

Sponsoring
----------

[](#sponsoring)

If you find this plugin useful, please consider [sponsoring us](https://github.com/sponsors/oveleon) to help contribute to our time invested and to further development of this and other open source projects. Thank you for your support! - [Oveleon](https://www.oveleon.de).

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance77

Regular maintenance activity

Popularity29

Limited adoption so far

Community29

Small or concentrated contributor base

Maturity89

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 67.1% 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 ~23 days

Recently: every ~49 days

Total

101

Last Release

55d ago

Major Versions

1.5.3 → 2.0.02023-09-28

1.5.4 → 2.0.112024-02-21

1.5.5 → 2.0.122024-02-27

1.5.6 → 2.0.162024-04-18

1.5.7 → 2.1.52024-08-02

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

1.4.3PHP ^7.0 || ^8.0

2.0.0-RC1PHP ^7.4 || ^8.0

2.0.0PHP ^8.1

2.4.0PHP ^8.3

### 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 (527 commits)")[![doishub](https://avatars.githubusercontent.com/u/48379929?v=4)](https://github.com/doishub "doishub (168 commits)")[![eki89](https://avatars.githubusercontent.com/u/8254646?v=4)](https://github.com/eki89 "eki89 (76 commits)")[![9teufel](https://avatars.githubusercontent.com/u/16761621?v=4)](https://github.com/9teufel "9teufel (5 commits)")[![Suschi88](https://avatars.githubusercontent.com/u/115069701?v=4)](https://github.com/Suschi88 "Suschi88 (5 commits)")[![tomjpeg](https://avatars.githubusercontent.com/u/75305857?v=4)](https://github.com/tomjpeg "tomjpeg (3 commits)")[![lindesbs](https://avatars.githubusercontent.com/u/62198?v=4)](https://github.com/lindesbs "lindesbs (1 commits)")

---

Tags

contaocontao-bundleskinthemetoolsetcssmanagercontaotheme

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/contao-thememanager-core/health.svg)

```
[![Health](https://phpackages.com/badges/contao-thememanager-core/health.svg)](https://phpackages.com/packages/contao-thememanager-core)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M373](/packages/easycorp-easyadmin-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[symfony/framework-bundle

Provides a tight integration between Symfony components and the Symfony full-stack framework

3.6k246.0M11.1k](/packages/symfony-framework-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M517](/packages/shopware-core)[symfony/security-bundle

Provides a tight integration of the Security component into the Symfony full-stack framework

2.5k181.3M2.2k](/packages/symfony-security-bundle)[contao-community-alliance/dc-general

Universal data container for Contao

1579.5k90](/packages/contao-community-alliance-dc-general)

PHPackages © 2026

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