Author a Beskid Template
First-party templates use the beskid.templates.* registry namespace. A template authoring tree is not a runnable Beskid project.
Prerequisites
Section titled “Prerequisites”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 path | Purpose |
|---|---|
<package>/.beskid/template.json | Engine manifest for the authoring tree. |
<package>/<name>.bproj | Package metadata and template identity. |
<package>/content/, workspace/, or item/ | Files copied to template output. |
beskid_templates.bws | Workspace membership for all template packages. |
workspace.package.json | Publication metadata for the seven registry packages. |
Actions
Section titled “Actions”- Inspect
.beskid/template.jsonin the template package that you own. - Use only
{{symbolId}}placeholders in copied source paths and content. - Run
beskid new --path ./packages/console -n Demo -o ./Demofrombeskid_templates/to test local-path instantiation. - Inspect the generated template output without editing the authoring source through that output.
- Run
bash scripts/ci/corelib-publish.sh --dry-runfrom the initialized superrepo root.
Expected result
Section titled “Expected result”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.
Recovery
Section titled “Recovery”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.
Next task
Section titled “Next task”Create a project from a verified template, or publish a package after the owning release workflow approves it.