PHPackages                             psi/contao-livereload - 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. psi/contao-livereload

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

psi/contao-livereload
=====================

Contao CSS Livereload Client

1.1.1(11y ago)5422[1 issues](https://github.com/psi-4ward/contao-livereload/issues)LGPL-3.0+PHPPHP &gt;=5.3

Since Nov 17Pushed 11y ago2 watchersCompare

[ Source](https://github.com/psi-4ward/contao-livereload)[ Packagist](https://packagist.org/packages/psi/contao-livereload)[ Docs](https://github.com/psi-4ward/contao-livereload)[ RSS](/packages/psi-contao-livereload/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (4)Used By (0)

Contao CSS Livereload
=====================

[](#contao-css-livereload)

Livereload the CSS in the Browser whenever a file changes.

- **Supports the Contao Combiner !**
- Supports LessCSS
- Supports SASS (Compass)

[![Video](https://camo.githubusercontent.com/30b6b4c87d7ea4d3bd9f4f9ed16f8b5f96b73084f704b52315a9a3db33a09d54/687474703a2f2f696d672e796f75747562652e636f6d2f76692f744c433631616b684830672f302e6a7067)](http://www.youtube.com/watch?v=tLC61akhH0g)

How it works
------------

[](#how-it-works)

1. You have to run the contao-livereload-server on the Machine holding the Stylesheet files.
2. You have to install the contao-livereload extension and enable it in your user-profile
3. Whenever you load a Contao page in your Browser a AJAX call tells the livereload-server which (uncombined) stylesheets youre working with.

Client installation
-------------------

[](#client-installation)

Use Composer!
*Or copy all files to system/modules/contao-livereload and update the database*

Server installation
-------------------

[](#server-installation)

1. You need NodeJS and NPM installed! [Google knows how](https://www.google.com/?q=How+to+install+nodejs)
2. Run `sudo npm -g install contao-livereload`
    *You can use one server installation for every contao project*

Using Contao-Livereload
-----------------------

[](#using-contao-livereload)

1. Run the `contao-livereload` file from any contao root directory
2. Activate the feature in your Backend-User Profile (`contao/main.php?do=login`)
3. Open any contao frontend page
4. Start editing your CSS/LESS
5. Enjoy the magic

Tipps
-----

[](#tipps)

- Add watchers to trigger the livereload for files not directly referenced in Contao. Useful if you have `@import` in your less files:
    `contao-livereload -w files/layout/**/*.less`
- You can run the Contao-Livereload-Server on your webserver, be sure to configure the correct Host in your backend profile. If you have problems check the server firewall.

Server usage
------------

[](#server-usage)

```
Usage: contao-livereload -d path -w "files/layout/**/*.less"

Examples:
  contao-livereload -d ContaoProject -w files/layout/**/*.less -w files/layout/**/*.css

Options:
  -d  Contao directory path, default is the current working directory
  -w  Add file watchers, you can use globbing
  --lr-port   Port of the livereload server                                    [default: 35729]
  --req-port  Port listen on for Contao requests                               [default: 35720]
  -h  Help

```

### example output

[](#example-output)

```
psi@psi:~webroot/isotopedemo$ contao-livereload -w "files/layout/*.less" -w "files/base.css"
[gulp] Using gulpfile ~/webroot/contao-livereload/gulpfile.js
[gulp] Starting 'default'...
[19:21:57] Assume Contao root directory in /home/psi/webroot/isotopedemo
[gulp] Finished 'default' after 87 ms
[19:21:57] Live reload server listening on: 35729
[19:21:57] Contao Handler listening on: 35720
[19:21:57] Waiting for Contao requests ...
[19:22:07] Received contao live-reload request
[19:22:07] Watching for livereload system/modules/isotope/assets/css/isotope.min.css
[19:22:07] Watching for livereload assets/css/8900add6f135.css
[19:22:07] Watching for combining files/layout/*.less
[19:22:07] Watching for combining files/base.css
[19:22:07] Watching for combining assets/contao/css/layout.css
[19:22:07] Watching for combining assets/contao/css/responsive.css
[19:22:07] Watching for combining assets/contao/css/grid.css
[19:22:07] Watching for combining assets/contao/css/reset.css
[19:22:07] Watching for combining files/font-awesome-4.0.3/css/font-awesome.min.css
[19:22:07] Watching for combining files/contaodemo/contaodemo.css
[19:22:07] Watching for combining files/isotopedemo/isotopedemo.css
[19:23:48] files/isotopedemo/isotopedemo.css was changed
[19:23:48] 8900add6f135.css was reloaded.

```

License:  LGPL
Author: Christoph Wiechert [4ward.media](http://www.4wardmedia.de)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

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

Total

3

Last Release

4177d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d404ebaec3f8046ad94cfdfd5338faf3b7aa037eee91ae95a8e46dfa436884aa?d=identicon)[psi-4ward](/maintainers/psi-4ward)

---

Top Contributors

[![psi-4ward](https://avatars.githubusercontent.com/u/1191572?v=4)](https://github.com/psi-4ward "psi-4ward (17 commits)")[![kikmedia](https://avatars.githubusercontent.com/u/1022895?v=4)](https://github.com/kikmedia "kikmedia (1 commits)")[![valentin-](https://avatars.githubusercontent.com/u/90033?v=4)](https://github.com/valentin- "valentin- (1 commits)")

---

Tags

contao

### Embed Badge

![Health badge](/badges/psi-contao-livereload/health.svg)

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

PHPackages © 2026

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