README
¶
Tmplt
A production-ready starting point for Go projects. Generate an independent repository and begin with CI, security, signed releases, installation, self-update, and future template updates already wired.
Disclaimer: Made by an automated agent. The code was not extensively reviewed; use at your own risk. It works on my machine.
What is ready?
- Podman/Docker-only build, test, run, security, and release commands
- Optional Distrobox development shell
- Branch and pull-request CI using the same container toolchain
- Automatic minor releases from
mainand releases from explicit tags - Linux, macOS, and Windows artifacts with checksums and Ed25519 signatures
- Verified in-binary self-update and dependency updates through Renovate
- Focused guidance for both human and agent contributors
Install and update
On Linux or macOS:
curl -fsSL --proto '=https' --proto-redir '=https' https://git2.riper.fr/ztec/tmplt/raw/branch/main/install.sh | sh
Windows users can download the matching ZIP from Releases. Every platform can update an installed release with:
tmplt self-update
The installer and self-update both verify the Ed25519 signature using the current public-key status from Tmplt's Forgejo main, then verify the archive checksum and embedded version. The installer uses OpenSSL; if it is unavailable, it explains the checksum-only risk and asks before continuing. An unattended, explicit bypass is available as a last resort:
curl -fsSL --proto '=https' --proto-redir '=https' https://git2.riper.fr/ztec/tmplt/raw/branch/main/install.sh | sh -s -- --skip-signature-verification
Start
tmplt
make test # Podman or Docker
make build
make run
make shell # optional Distrobox environment
Create a project with make template-new DEST=/absolute/path; the template lifecycle guide explains the recorded choices and make tmplt-update. Focused detail lives in the CLI, development, and release guides.
Contributions are welcome; read CONTRIBUTING.md. Security reports follow SECURITY.md.
Licensed under the MIT License.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
tmplt
command
|
|
|
tmplt-release-sign
command
release-sign creates and uses the Ed25519 key material for release checksums.
|
release-sign creates and uses the Ed25519 key material for release checksums. |
|
internal
|
|
|
buildinfo
Package buildinfo exposes project identity and release values.
|
Package buildinfo exposes project identity and release values. |
|
cli
Package cli defines the tmplt command-line interface.
|
Package cli defines the tmplt command-line interface. |
|
selfupdate
Package selfupdate adapts the reusable updater to this project's identity.
|
Package selfupdate adapts the reusable updater to this project's identity. |
|
kit
|
|
|
releaseverify
Package releaseverify loads the shared release-key registry and verifies Ed25519-signed release metadata.
|
Package releaseverify loads the shared release-key registry and verifies Ed25519-signed release metadata. |
|
selfupdate
Package selfupdate downloads, verifies, and installs release binaries.
|
Package selfupdate downloads, verifies, and installs release binaries. |