Template Authoring

Template Authoring

Overview for anyone who wants to write their own templates.

Learning path

Step	Topic	Page
1	Minimal template	Your First Template
2	Manifest	template.lua Reference
3	Questions	questions.lua Reference
4	Files	Files & Prebyte
5	Layout	layout.lua
6	Layering	Includes & Layering
7	Hooks	Hooks (Authors)
8	Quality	Template Quality
9	Tests	Template Tests
10	Updates	Versioning & Reapply

Minimal structure

templates/my_app/
  template.lua       # required
  questions.lua      # recommended
  files/             # required (may be empty with subdirs)
    README.md.pbt

Optional: layout.lua, hooks/, scripts/, tests/, .env, includes.lua

Workflow

tempify validate my_app
tempify lint my_app
tempify inspect my_app
tempify test my_app
tempify my_app /tmp/out --set ...

Reference templates in the repo

See Example Catalog (tests/test_templates/).

Planned / not in CLI

A tempify new template scaffold is not implemented yet - templates are created manually or by copying.

See also

Home · Example Catalog