Skip to content

golusoris

A composable Go framework built around go.uber.org/fx. Pick the modules your app needs — nothing else ships.

import (
    "github.com/golusoris/golusoris"
    "github.com/golusoris/golusoris/otel"
)

fx.New(
    golusoris.Core,       // config · log · clock · id · validate · crypto
    golusoris.DB,         // pgx pool · migrate
    otel.Module,          // tracer · meter · logs · OTLP exporter
    golusoris.HTTP,       // chi router · HTTP server
    golusoris.K8s,        // pod metadata · Kubernetes client
    golusoris.Jobs,       // river client · worker registry
    golusoris.CacheRedis, // rueidis distributed cache
    // ... add what you need
).Run()

The default core/config.Module reads APP_ environment variables through koanf. Applications can opt into YAML or JSON files; packages without configuration expose constructors or options directly.

Documentation map

  • Contributing — Conventional Commits, DCO sign-off, CI gates, local dev commands, git hooks, and the release process.
  • Principles — coding and assurance contract (Power-of-10, SEI CERT, Google Go Style, RFC 9457, and evidence-backed supply-chain controls).
  • Architecture Decisions — Nygard-format ADRs, one per decision.
  • Architecture — C4 diagrams for the system.
  • Migration Guides — current constructor, atomic-store, secure-default, lifecycle, and resource-bound upgrades; older guides remain in navigation.
  • Capability contract — every package → capability keys → replaced modules; what praetor needs resolves against.
  • Licensing — EUPL-1.2 code, CC-BY-SA-4.0 prose, REUSE, DCO.
  • Governance — project scope, decision process, and maintainer roles.
  • Security — supported versions and how to report a vulnerability.
  • Upstream Snapshots — version-pinned API references for the framework's dependencies.
  • CI / Downstream Consumption — how apps consume tools/Makefile.shared and the reusable GitHub Actions workflows.

The source lives on GitHub.