Skip to content

Releases: fireflyframework/fireflyframework-go

v26.05.01 — first public release

07 May 21:26

Choose a tag to compare

First public release of the Firefly Framework — Go port. The
companion to the Java/Spring Boot original and the .NET 10 sibling
(fireflyframework-dotnet).

Highlights

  • 52 modules across 4 strictly-layered tiers (Foundational → Platform → Adapters → Starters).
  • Per-module README.md for every module, matching the .NET port's depth — overview, design rationale, public surface, runnable quick-start, testing notes.
  • GoDoc-grade comments on every exported symbol — go doc against any module yields a complete reference page.
  • Spring-Boot parity: typed configuration (config), application lifecycle (lifecycle), actuator endpoints (actuator), task scheduling (scheduling), resilience patterns (resilience), HTTP-layer security (security), SQL migrations (migrations), OpenAPI generation (openapi), i18n (i18n), Server-Sent Events (sse), @Transactional (transactional), and a shared testing toolkit (testkit).
  • Wire-compatible with the Java + .NET releases — same application/problem+json envelopes, same Idempotency-Key semantics, same saga step / event / RBAC contracts.
  • Reference sample at samples/orders/ with idempotent POST, query-cached GET, lifecycle-driven boot, and actuator on a separate admin port.

Quality bar

Gate Result
go build ./... 52 / 52 ✅
go test ./... 52 / 52 ✅
go test -race ./... 52 / 52 ✅
go vet ./... 0 issues ✅
gofmt -l . clean ✅

Module index

See MODULES.md for the full per-module index.

Quick start

git clone https://github.com/fireflyframework/fireflyframework-go.git
cd fireflyframework-go
make ci      # fmt + vet + build + test across the workspace
make sample  # runs samples/orders on :8080 (public) + :8081 (actuator)