ubgo
Small cores
The core module has no third-party dependencies, so importing it adds nothing to your go.sum.
Batteries included for Go, one module at a time.
ubgo is an ecosystem for building Go apps, in the spirit of the components Laravel ships for caching, logging and configuration. Every piece is its own Go module, so a service imports only what it uses. The main libraries share one shape, a small core with adapters outside it and a shared test suite, so learning one teaches you the next.
go get github.com/ubgo/<name>
or press Ctrl K to jump to any library
A small core. Adapters outside it.
Pick a library to see its real core and the modules that plug into it.
- passes the suite
- does not pass
- public libraries
- 45public libraries
- Go modules
- 209Go modules
- adapters in contrib/
- 76adapters in contrib/
- shared conformance suites
- 4shared conformance suites
Counted from the public repos' go.mod files and contrib/ folders.
How ubgo compares
ubgo is not one framework you adopt whole. It is a set of Go modules that follow the same rules.
ubgo is
- Separate Go modules. 209 go.mod files across the 45 public libraries. You add the ones you use. See the map
- Small cores, adapters outside them. 76 adapter modules live in
contrib/folders, so an integration's dependencies stay out of your build until you import it. For example errx, logger and health. - Backends you can swap, checked by one suite. cache (
cachetest), cache-obj (objtest), cfgkit (cfgkittest), sqlb (sqlbtest): a backend counts only when its tests run the suite. - Fits the HTTP stack you already use. health, shutdown and buildinfo ship adapters for net/http, Gin, Chi, Echo and Fiber.
ubgo is not
- A web framework. There is no ubgo router or request lifecycle. You keep your own, and the libraries plug into it.
- An ORM. sqlb builds typed SQL; entkit and entx extend the ent ORM instead of replacing it.
- All or nothing. A library needs another one only when its go.mod says so, and the map draws every one of those links.
New: Volt
From libraries to a shipped program
ubgo libraries are the parts your code runs on. Volt is the layer on top: the volt tool scaffolds a CLI, runs the CI gate, builds for every platform and makes releases it checks after publishing, and its kit modules give a CLI the parts every CLI needs.
Meet Volt
brew install khanakia/tap/volt3 · Your app
A CLI, a library or a service
mytool (volt new cli)your libraryyour service
app starters are coming
2 · Volt tooling
voltkit →The Volt tool
volt newvolt statusvolt civolt covervolt buildvolt releasevolt gen
Kit modules you import
appdiroutputskillcmdversioncmd
Real link: voltkit's versioncmd module requires ubgo/buildinfo in its go.mod.
Explore
Featured libraries
The ones most services reach for first.
- errx Errors and logging
One structured error type with stable identity, class, redactable fields, return traces and a wire codec.
0 core deps8 adapters - logger Errors and logging
Adapter-based, slog-native structured logging with sampling, redaction, OpenTelemetry and rotation.
0 core deps7 adapters - cache Caching
The core cache interface with generics, single-flight Remember, a distributed locker and a shared conformance suite.
v0.1.00 core deps13 adapterscachetest - cfgkit Config and env
Typed config from env, .env, JSON, YAML, TOML, flags and secret stores into one validated struct.
v0.1.01 core deps19 adapterscfgkittest - sqlb SQL and data
Typed SQL builder with compile-checked columns and joins, Postgres and ClickHouse packages and a driver conformance suite.
v0.1.10 core deps7 adapterssqlbtest - gqlkit GraphQL and ent
Generates typed GraphQL client SDKs for Go and TypeScript with compile-checked field selection.
1 core deps - health HTTP and services
Thread-safe health and readiness registry with k8s-style probes, framework adapters and ready-made checkers.
v0.1.00 core deps12 adapters - crypt Crypto
Go crypto with safe defaults (AES-GCM, ChaCha20-Poly1305, argon2id, HMAC, Ed25519, key rotation), byte-compatible with crypt-ts.
v0.2.01 core deps - docsync Tooling
Finds the sentences in your docs that stopped being true when the code they describe changed.
v0.1.60 core deps
How several of them are built
True for the libraries named under each one, as their READMEs state. Not a promise for every repo.
Adapters live outside the core
Integrations (frameworks, OpenTelemetry, drivers, secret stores) ship as separate modules, so you only download what you import.
Shared conformance suites
A family's contract is a test suite that every backend runs, so backends behave the same.
By area
Caching
11One cache interface with in-memory, Redis, Postgres, Memcached, tiered and cluster backends.
SQL and data
7SQL building, JSON column types, IDs and locks.
GraphQL and ent
6Helpers and code generation for gqlgen and the ent ORM.
HTTP and services
8HTTP calls, health checks, graceful shutdown and build info.
More libraries are on the way.