Getting Started

Getting Started

From template to generated project folder in a few minutes.

When do you need this?

You want to use an existing template and generate a new project folder - without writing Lua or Prebyte yourself.

Prerequisites

• Installation complete
• A workspace with templates/or templates installed in the Shared Template Store

Step 1: List templates

tempify list

JSON variant:

tempify list --json

Details for one template:

tempify info basic_cpp

Step 2: Preview questions (optional)

tempify basic_cpp --questions
tempify basic_cpp --questions --json

This shows which values you need to set (project_name, name_slug, …).

Step 3: Render

tempify basic_cpp my-app \
--set project_name="My App" \
--set name_slug=my-app \
--set namespace=app_ns \
--set include_ci=false \
--set author=Me

Result:

• Folder my-app/ with generated files (README.md, src/main.cpp, …)
• .tempify-lock.json - metadata for later reapply
• .tempify-summary.txt - compact value summary (depending on template)

Alternative: answers file

cat > answers.json <<'EOF'{ "project_name": "My App", "name_slug": "my-app", "namespace": "app_ns", "include_ci": false, "author": "Me"}EOF
tempify basic_cpp my-app --answers answers.json

Interactive (TUI)

tempify basic_cpp my-app --tui

Plan without writing

tempify basic_cpp my-app --dry-run
tempify basic_cpp my-app --plan-json

Common errors

Message	Fix
Template not found	Check tempify list, run tempify refresh for shared store
Target already exists	Use -f (overwrite) or -s (keep existing files)
Missing answer for …	Add --set, use --answers, or drop --non-interactive

Next steps

• Questions & Answers
• Configuration
• Reapply & Diff - update a project later