Skip to content

Pug template engine adapter for Slim


Notifications You must be signed in to change notification settings



Folders and files

Last commit message
Last commit date

Latest commit



32 Commits

Repository files navigation

Pug for Slim

Latest Stable Version Build Status Code Climate Test Coverage Issue Count StyleCI

For details about the template engine see


Install with Composer:

composer require pug/slim

Usage with Slim 3

use Slim\App;
use Slim\Pug\PugRenderer;

include 'vendor/autoload.php';

$slimOptions = []; // here you can pass Slim settings
$app = PugRenderer::create(new App($slimOptions), './templates');

$app->get('/hello/{name}', function ($request, $response, $args) {
    return $this->renderer->render($response, 'hello.pug', $args);


PS: If you don't pass an application to the create method, we will automatically initialize one, so you can just do:

use Slim\Pug\PugRenderer;

include 'vendor/autoload.php';

$app = PugRenderer::create(null, './templates');

Usage with any PSR-7 Project

//Construct the View
$pugView = new PugRenderer('./path/to/templates', [
  'option' => 'foobar',

//Render a Template
$response = $pugView->render(new Response(), '/path/to/template.pug', $yourData);

Template Variables

You can add variables to your renderer that will be available to all templates you render.

// via the constructor
$templateVariables = [
  'title' => 'Title',
$pugView = new PugRenderer('./path/to/templates', [], $templateVariables);

// or setter

// or individually
$pugView->addAttribute($key, $value);

Data passed in via ->render() takes precedence over attributes.

$templateVariables = [
  'title' => 'Title',
$pugView = new PhpRenderer('./path/to/templates', $templateVariables);


$pugView->render($response, $template, [
    'title' => 'My Title',
// In the view above, the $title will be "My Title" and not "Title"

By default, pug-php is used. But you can specify an other engine:

$app = PugRenderer::create(null, null, [
  'renderer' => \Phug\Renderer::class,

PS: Phug is automatically installed with default install since Pug-php 3 use it internally. But you can also install different renderer engine, for example tale-pug:

composer require talesoft/tale-pug
$app = PugRenderer::create(null, null, [
  'renderer' => \Tale\Pug\Renderer::class,

Note that in this case, you have no guarantee that all options will work.



This project is forked from And we added to it phug, pug-php 3, tale-jade and tale-pug support.