Skip to content
Beskid Beskid

Beskid

Jump to a Beskid service

Beskid

Jump to a Beskid service

Author a Beskid Template

First-party templates use the beskid.templates.* registry namespace. A template authoring tree is not a runnable Beskid project.

Use an initialized superrepo with the pinned beskid_templates gitlink. Choose an empty output path for local instantiation. Work from the superrepo root for the publication dry-run.

Authoring pathPurpose
<package>/.beskid/template.jsonEngine manifest for the authoring tree.
<package>/<name>.bprojPackage metadata and template identity.
<package>/content/, workspace/, or item/Files copied to template output.
beskid_templates.bwsWorkspace membership for all template packages.
workspace.package.jsonPublication metadata for the seven registry packages.
  1. Inspect .beskid/template.json in the template package that you own.
  2. Use only {{symbolId}} placeholders in copied source paths and content.
  3. Run beskid new --path ./packages/console -n Demo -o ./Demo from beskid_templates/ to test local-path instantiation.
  4. Inspect the generated template output without editing the authoring source through that output.
  5. Run bash scripts/ci/corelib-publish.sh --dry-run from the initialized superrepo root.

Local instantiation creates template output at the selected empty path. The publication dry-run validates and packs the complete first-party set. It performs no registry write and needs no publication credential.

If generated output is wrong, change the owned authoring tree and instantiate into a new empty path. If the dry-run fails, stop at the first failing artifact. Do not continue to a registry write.

Do not add a corelib opt-out key to emitted project manifests. Follow the pinned source and the linked normative authority when the expected shape is unclear.

Create a project from a verified template, or publish a package after the owning release workflow approves it.