Authoring packages

Guides for package and catalog authors: writing a pkg.yaml, validating it, and publishing a catalog to a registry. For the complete manifest schema, see the pkg.yaml schema reference.

Write a pkg.yaml

Define how a tool is fetched and installed.

Validate

Lint manifests with nem author lint.

Publish a catalog

Pack and push a catalog to a registry.

Mirror package artifacts

Push archives and sources into a registry.

Catalog structure

A catalog is a directory with a pkgs/ folder that holds one subdirectory per package, each containing a single pkg.yaml manifest:

my-catalog/
├── pkgs/
│   ├── ripgrep/
│   │   └── pkg.yaml
│   └── kubectl/
│       └── pkg.yaml
└── README.md

The directory name under pkgs/ is the package name used with nem use. A catalog carries no code — only manifests.