Go service template (exemplar)

go-service-template is a complete, deployed reference implementation of a Theseus service. Where the docs describe the paved path, this repository shows it finished: every convention on this site appears there as working, reviewed code, running in staging and production on Runway.

It demonstrates:

• Scaffolding — generated from common-template-copier and kept current with copier update
• Three-layer architecture — transport → domain → store, with outbound HTTP clients outside the layers and a single composition root in cmd/server/main.go
• LabKit v2 throughout — structured logging, OpenTelemetry tracing, Prometheus metrics, health endpoints, protobuf-first validated configuration (v2/config), secrets via v2/secret, and feature flags
• Local development with Caproni — mise run up deploys the service into a local cluster from the Fairway-generated chart, alongside in-cluster PostgreSQL and a feature-flag backend, with mirrord-based hot reload
• Production deployment on Runway — the same chart pipeline the Get Started tutorial sets up

Resources

• Project
• Staging / Production — the running service
• Get Started — scaffold your own service with the same layout
• LabKit — the library layer the exemplar builds on