Stamp: Generate files from templates and data files

v2.2.1 2019-11-25 13:09 UTC


Stamp generate files by applying data to templates.


  • Generate common repository files like, LICENSE, .gitignore, etc (by combining stamp with metaculous)
  • Static site generator
  • Documentation generator


composer require linkorb/stamp --dev


vendor/bin/stamp --help

How does it work?

When you run stamp generate, Stamp will look for it's configuration in a file called stamp.yaml in the current directory. You can also pass a specify config file using -c.

Stamp will then loop through the templates defined in the config file, and use the template files defined by the src key, and generate the file defined by the dest key.

By specifying an items key, one template may be applied multiple times, resulting in multiple output files.

By specifying a variables key, the variables at the template level will get merged with the project level variables before being passed to the template, allowing you to override/add variables at the template level.

stamp.yml example:

Here's a simple example stamp.yml file:

  title: Hello world
  license: mit

  - src: stamp/
      title: Hello world README file

  - src:{{ license }}.md
    dest: LICENSE
  - src:

Simply type stamp generate (or vendor/bin/stamp generate) in the root of your project, and the listed files will be (re)generated based on their templates.

Using URLs as templates allow you to manage your templates in one location (a git repository), making it easy to update your projects based on updated templates.

Stamp supports multiple template languages/engines, which will be used based on the template file (src) file extension:

Variables and functions

Stamp is using the LinkORB Loader library for loading the stamp.yaml file.

It therefor supports all features related to variables, includes and functions that the loader does.

Development / debugging:

The examples/ directory contains an example configuration (stamp.yaml) and template files.


MIT. Please refer to the license file for details.

Brought to you by the LinkORB Engineering team

Check out our other projects at

Btw, we're hiring!