Skip to content
HomePagesHomePages template kit
Menu
Start here
QuickstartOverview
The contract
The schema systemThe closed authoring vocabularyContract primitivesStatic assetsTheme and CSSIslands: interactivity in a template
Tooling
template-kit checktemplate-kit devAdding templates and sectionstemplate-kit packESLint presetUpgrading the kit
Recipes
RecipesBind a slot to a property factA collection slot — a repeating, per-item listHave AI write a slot's contentPreview a section's structural edge casesImage slot with a locked cropMake part of a section interactiveAdd a lead formOrganize a section's files beyond the four reservedPick a scenario for a fixturePrepare a submissionAdd a second templateA select slot — a closed set of choicesAdd a static asset (image, icon, font)Use a third-party npm package in a section
Rules
Rulestemplate-kit/audit-severitytemplate-kit/bundle-binary-assettemplate-kit/bundle-incompletetemplate-kit/css-reasontemplate-kit/determinism-drifttemplate-kit/fixtures-invalidtemplate-kit/image-bare-needs-reasontemplate-kit/license-deniedtemplate-kit/lockfile-missingtemplate-kit/lockfile-staletemplate-kit/manifest-invalidtemplate-kit/missing-slot-markertemplate-kit/no-bare-css-importtemplate-kit/no-client-directive-in-contracttemplate-kit/no-client-runtime-in-servertemplate-kit/no-css-import-from-render-pathtemplate-kit/no-hextemplate-kit/no-inline-styletemplate-kit/no-nondeterminismtemplate-kit/no-raw-elementtemplate-kit/no-templatestemplate-kit/parse-errortemplate-kit/props-from-schematemplate-kit/render-invarianttemplate-kit/require-island-editortemplate-kit/schema-invalidtemplate-kit/serializable-island-propsServer vs clienttemplate-kit/sidebar-ordertemplate-kit/single-reacttemplate-kit/size-assetstemplate-kit/size-island-bundletemplate-kit/size-renderer-bundletemplate-kit/size-section-csstemplate-kit/slot-group-markertemplate-kit/slot-marker-literaltemplate-kit/typechecktemplate-kit/unlayered-fence

Add a second template

Add another template to the workspace.

Goal

Section titled “Goal”

Add another template to the workspace.

The delta

Section titled “The delta”
Terminal window
template-kit new <name>

new creates templates/<name>/ as a working starter template — the same starter shape a fresh workspace ships (a text slot, an image slot, a fact-bound slot, an option, fixtures, a fill spec, a components/ folder, a "use client" island, theme.ts/theme.css, manifest.json) — and it already passes check as-is. Edit its sections from there.

A template is a plain folder under templates/. Adding one does not duplicate anything: every template in the workspace shares the same kit version, the same root package.json/lockfile, and the same tsconfig.json/ESLint config. There is nothing per-template to configure beyond the folder itself.

new refuses to overwrite an existing templates/<name>/ folder.

Commands

Section titled “Commands”
Terminal window
template-kit new <name>
template-kit check <name>

Verify

Section titled “Verify”

Verify with the author loop — a freshly created template is check-clean before you change a line.

See also

Section titled “See also”
  • Adding templates and sections — the full command, including new-section for adding a section within a template.
  • Check — the gate every template (new or edited) must pass.