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

template-kit pack

The `template-kit pack` command — what it produces, what it refuses, and why.

Build a template’s submission artifact: a zip of the template’s source plus the workspace lockfile, validated and stamped.

Usage

Section titled “Usage”
Terminal window
template-kit pack <template>

Run it from the workspace root, or from inside a template folder (the template is inferred). In a workspace with several templates you must name one — the submission unit is a single template.

What it produces

Section titled “What it produces”

<template>.zip at the workspace root, containing:

  • pack-manifest.json — the exact kit version the source was validated against, a content hash of the template tree, the pack timestamp, and a check flag recording that validation passed.
  • package.json and package-lock.json from the workspace root, so the build is reproducible with npm ci.
  • templates/<template>/ — the template’s source only (sections, manifest, theme, README). No node_modules, no build output, no other template.

What it refuses

Section titled “What it refuses”

pack will not produce a zip when:

  • check <template> is not green — fix the reported problems first.
  • the workspace has no package-lock.json — run npm install and commit it.
  • a dependency uses a local file:/link: protocol — depend on published versions.

Fix the reported cause and run it again.

See also

Section titled “See also”
  • Check — the gate pack runs before it will produce a zip.