Socotra
Concepts

Templates

The template system that scaffolds code into your projects.


What is a template

A template is a directory of .cs files that share a single declared C# namespace. That namespace acts as a token: when the template is applied, every occurrence is replaced with the target project's namespace.

Three sources

SourcePrefixExample
Built-in(none)base-entity
GitHubgithub:github:my-org/socotra-templates/audit-entity
Local path[object Object] /./my-templates/audit-entity

Namespace and content tokens

In addition to namespace normalization, two content tokens are substituted in template files: {{Name}} resolves to PascalCase of the template name, and {{Namespace}} resolves to the full target namespace.

Project vs global scope

Templates can be cached per-project at .socotra/templates/ (shared via Git) or globally at ~/.socotra/registry/ with --global. See authoring for the full pipeline.

Schema 1.1 · CLI 1.0