PHPackages                             getherbie/herbie - 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. [Templating & Views](/categories/templating)
4. /
5. getherbie/herbie

ActiveLibrary[Templating & Views](/categories/templating)

getherbie/herbie
================

Herbie is a simple, modern, fast and highly customizable flat-file Content Management System (CMS) powered by PHP, Twig, Markdown, Textile, reStructuredText and other human-readable text files.

v2.2.0(11mo ago)892.2k14[6 issues](https://github.com/getherbie/herbie/issues)[1 PRs](https://github.com/getherbie/herbie/pulls)20BSD-3-ClausePHPPHP >=8.0CI failing

Since Nov 11Pushed 11mo ago8 watchersCompare

[ Source](https://github.com/getherbie/herbie)[ Packagist](https://packagist.org/packages/getherbie/herbie)[ Docs](https://herbie.tebe.ch/)[ RSS](/packages/getherbie-herbie/feed)WikiDiscussions 2.x Synced 3d ago

READMEChangelog (10)Dependencies (32)Versions (38)Used By (20)

[![Packagist](https://camo.githubusercontent.com/570c635dcdeae36a2f6e8c8ece0b23068d3bec040ef44d57d2574f6a9f96d161/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6765746865726269652f6865726269652e737667)](https://packagist.org/packages/getherbie/herbie)[![GitHub (pre-)release](https://camo.githubusercontent.com/52ab1b2942355aa18814f02c40e50b2784b5227533fea49c93723a2984778fa6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6765746865726269652f6865726269652f616c6c2e737667)](https://github.com/getherbie/herbie/releases)[![License](https://camo.githubusercontent.com/b3775a2de17853a90995faa104f941eef3ad3c40cc89e34b8b1eaea014614d4e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d425344253230332d2d436c617573652d626c75652e737667)](https://github.com/getherbie/herbie/blob/master/LICENCE.md)[![PHP from Packagist](https://camo.githubusercontent.com/d6d3c5fbf5e953bf228266cbd943621d5a8f31031d3652564c46d6b7f69b44e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6765746865726269652f6865726269652e737667)](https://packagist.org/packages/getherbie/herbie)

Herbie
======

[](#herbie)

> Create small but fully functional websites or blogs in no time and with little effort 👌

Herbie is a simple, modern, fast and highly customizable flat-file Content Management System (CMS) powered by PHP, Twig, Markdown, Textile, reStructuredText and other human-readable text files.

Featuring
---------

[](#featuring)

Herbie is powered by proven libraries:

- [Markdown](https://www.markdownguide.org), [reStructuredText](https://docutils.sourceforge.io/rst.html) and [Textile](https://textile-lang.com) for formatting page content
- [Twig](https://twig.symfony.com) template engine for rendering layouts and extending the core
- [Yaml](http://www.yaml.org) and [JSON](https://www.json.org) for data structure files
- [Composer](http://getcomposer.org) and [Packagist](https://packagist.org) for Dependency and Plugin Management

Thanks to its plugin system Herbie is highly customizable and brings support for:

- Application and Route Middlewares
- Event Listeners
- Twig Filters, Twig Globals, Twig Functions and Twig Tests
- Symfony Console Commands

Herbie implements the following PHP standard recommendations:

- [PSR-1](https://www.php-fig.org/psr/psr-1/) Basic Coding Standard
- [PSR-3](https://www.php-fig.org/psr/psr-3/) Logger Interface
- [PSR-4](https://www.php-fig.org/psr/psr-4/) Autoloading Standard
- [PSR-7](https://www.php-fig.org/psr/psr-7/) HTTP Message Interface
- [PSR-11](https://www.php-fig.org/psr/psr-11/) Container Interface
- [PSR-12](https://www.php-fig.org/psr/psr-12/) Extended Coding Style
- [PSR-14](https://www.php-fig.org/psr/psr-14/) Event Dispatcher
- [PSR-15](https://www.php-fig.org/psr/psr-15/) HTTP Handlers
- [PSR-16](https://www.php-fig.org/psr/psr-16/) Simple Cache
- [PSR-17](https://www.php-fig.org/psr/psr-17/) HTTP Factories

Herbie is well tested:

- Unit, Integration and Acceptance Tests with [Codeception](https://codeception.com)
- Static Code Analysis with [PHPStan](https://phpstan.org)
- Code Fixing with [PHP Coding Standards Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer)

Supported PHP Versions
----------------------

[](#supported-php-versions)

8.0 / 8.1 / 8.2 / 8.3

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

[](#installation)

### With PHP and Composer on your machine

[](#with-php-and-composer-on-your-machine)

The easiest way to install Herbie is through Composer. Run the following commands in your terminal to create a new project and install all dependent libraries.

```
composer create-project getherbie/start-website mywebsite

```

Change to the `mywebsite/web` directory.

```
cd mywebsite/web

```

Start the built-in webserver.

```
php -S localhost:8888 index.php

```

Open  with your browser. You should see your first Herbie website.

### With Docker and Docker Compose on your machine

[](#with-docker-and-docker-compose-on-your-machine)

Create website and install dependencies.

```
docker run --rm -v $PWD:/app composer create-project --ignore-platform-reqs getherbie/start-website mywebsite

```

Change to the `mywebsite` directory and start website.

```
cd mywebsite
docker compose up website

```

Open  with your browser.

Development Environment
-----------------------

[](#development-environment)

If you need a development environment, you can follow these steps.

### With PHP and Composer on your machine

[](#with-php-and-composer-on-your-machine-1)

Clone the GitHub repository.

```
git clone https://github.com/getherbie/herbie.git

```

Change to the `herbie` directory.

```
cd herbie

```

Install Composer dependencies.

```
composer install

```

Change to the `website/web` directory.

```
cd website/web/

```

Start PHP's internal web server.

```
php -S localhost:8888 index.php

```

Open `localhost:8888` with your favorite web browser.

If you want to have additional console output or logging information, set the debug environment variable.

```
HERBIE_DEBUG=1 php -S localhost:8888 index.php

```

If you want to use Xdebug (3.x), start the internal web server as follows. Hint: For this to work, Xdebug must of course be installed.

```
XDEBUG_MODE=debug php -S localhost:8888 index.php

```

### With Docker and Docker Compose on your machine

[](#with-docker-and-docker-compose-on-your-machine-1)

Clone the GitHub repository.

```
git clone https://github.com/getherbie/herbie.git

```

Change to the `herbie` directory.

```
cd herbie

```

Start PHP's built-in web server and launch website.

```
docker compose up website

```

Open `localhost:8888` with your favorite web browser.

Other Docker Compose commands are

```
# install Composer dependencies
docker compose run install

# run test suite
docker compose run test

# start test suite website
docker compose up test-website

# run bash terminal
docker compose run bash

```

You can use different PHP versions.

```
PHP_VERSION=8.0 docker compose up website
PHP_VERSION=8.1 docker compose up website
PHP_VERSION=8.2 docker compose up website
PHP_VERSION=8.3 docker compose up website

```

Tests
-----

[](#tests)

### With PHP on your machine

[](#with-php-on-your-machine)

```
# run tests
php vendor/bin/codecept run

# run unit tests
php vendor/bin/codecept run unit

# run integration tests
php vendor/bin/codecept run integration

# run acceptance tests
php vendor/bin/codecept run acceptance

# run tests with Code Coverage
XDEBUG_MODE=coverage php vendor/bin/codecept run --coverage --coverage-xml --coverage-html

```

### With Docker Compose on your machine

[](#with-docker-compose-on-your-machine)

Open the container shell

```
docker compose run bash

```

Run tests within the container

```
# run tests
php vendor/bin/codecept run

# run unit tests
php vendor/bin/codecept run unit

# run integration tests
php vendor/bin/codecept run integration

# run acceptance tests
php vendor/bin/codecept run acceptance

# run tests with Code Coverage
XDEBUG_MODE=coverage php vendor/bin/codecept run --coverage --coverage-xml --coverage-html

```

More Information
----------------

[](#more-information)

For more information, see .

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance49

Moderate activity, may be stable

Popularity32

Limited adoption so far

Community27

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

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

Recently: every ~219 days

Total

21

Last Release

357d ago

Major Versions

v0.8.6 → v1.0.02016-03-25

v1.1.0 → v2.0.0-RC12022-12-28

PHP version history (3 changes)v0.5.0PHP >=5.4.0

1.x-devPHP >=5.6.0

v2.0.0-RC1PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/3bdbbcc7c6a4eb0680b6f21d894db260f9863c0743d34365f723545aed49525d?d=identicon)[getherbie](/maintainers/getherbie)

---

Top Contributors

[![tbreuss](https://avatars.githubusercontent.com/u/1334161?v=4)](https://github.com/tbreuss "tbreuss (1373 commits)")[![Netzweberei](https://avatars.githubusercontent.com/u/4253587?v=4)](https://github.com/Netzweberei "Netzweberei (54 commits)")

---

Tags

blogcmsflat-fileflat-file-cmsflatfileflatfilecmshacktoberfestmarkdownphptextiletwigwebsite-buildercmsblogflat fileherbie

###  Code Quality

TestsCodeception

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/getherbie-herbie/health.svg)

```
[![Health](https://phpackages.com/badges/getherbie-herbie/health.svg)](https://phpackages.com/packages/getherbie-herbie)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[sulu/sulu

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

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[symfony/symfony

The Symfony PHP framework

31.3k86.3M2.2k](/packages/symfony-symfony)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

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