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 authentication, caching, logging and configuration. Every piece is its own Go module, so a service imports only what it uses, from sign-in to caching. 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
Batteries included
Build almost any app
The pieces an app needs come out of the box: sign-in, SQL, caching, config, logging, jobs, health checks, GraphQL and HTML views, starters for the backend and the web app, and the tool that builds and releases it all. Each piece is its own module, so you take only what your app uses. Pick an app shape to see which modules it is built from.
Your app
SaaS backend
Interface
- authsign-in
- gqlkitGraphQL clients
- entxent extensions
- entkitent fields
- brickHTML views · upcoming
- validatorvalidation · upcoming
Run
- workflowjobs + cron · upcoming
- locklocks
- cachecaching
- healthhealth checks
- shutdowngraceful stop
- buildinfoversion info
Accounts and organizations, a typed SQL layer, caching, config, logs and telemetry, health checks and a clean shutdown, plus background jobs and cron.
- public module, links to its page
- upcoming, not public yet
Upcoming modules (workflow, brick, validator) are on the way and not public yet.
- public libraries
- 46public libraries
- Go modules
- 246Go modules
- adapters in contrib/
- 84adapters 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. 246 go.mod files across the 46 public libraries. You add the ones you use. See the map
- Small cores, adapters outside them. 84 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, and auth works with net/http, chi, Gin, Echo, Fiber and gqlgen.
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
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.
auth
New
Auth and identity
Embeddable authentication with plugins for email, password, phone, OAuth, passkeys, 2FA, API keys, JWT and organizations, stored in your own Postgres, MySQL or SQLite; it can also be the OpenID Connect login for your other apps.
v0.1.11 core dep36 plugins8 adapters
- password
- phone
- username
- magiclink
- oauth
- twofactor
- passkey
- apikey
- jwt
- organization
- admin
- ldap
- siwe
- +22 more
its own Go module, so its dependency is downloaded only when imported
- 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.70 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
Auth and identity
1Sign-in, sessions, two-factor, passkeys, OAuth and organizations, stored in your own database.
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.
Upcoming
Not public yet, so no links- workflow upcoming
Embeddable Go library for cron schedules, delayed and background jobs with retries, and multi-step workflows behind one Client interface, with swappable drivers (in-memory, SQL and Hatchet).
- brick upcoming
A component-based HTML render engine for Go built on html/template, with layouts, components, islands and server actions, and a 133-component UI kit.
- validator upcoming
Struct-native Go validator with a serializable IR; one set of rules validates in Go, exports to JSON Schema, and runs as a Standard-Schema TypeScript validator.