Releases And CI

What this page covers

How Postgram releases happen in this repository and where versions are published.

Core workflow

1. CLI publishes from merge to main via semantic-release:

• scope convention drives version bumps (feat(cli): ... etc.).

2. CLI package is published to npm with provenance flags.
3. Docker images are published to GitHub Container Registry on merge and semantic tag events.

CLI publishing

• Configured in .github/workflows/release-cli.yml
• Requires NPM_TOKEN repository secret.

Server image publishing

• Configured in .github/workflows/docker.yml
• Publishes multi-arch images to ghcr.io/ivo-toby/postgram.

Notes

• Non-CLI-scoped commits do not bump the CLI version.
• Docker image tags include latest, main, sha-<short>, and semantic tags when a v* Git tag is pushed.