go-mink
Event Sourcing & CQRS for Go — Built for developers who demand simplicity without sacrificing power.
The Problem We Solve
Building event-sourced applications in Go means wrestling with boilerplate code, manual projections, and scattered patterns. Most teams end up reinventing the wheel—or worse, avoiding event sourcing entirely.
go-mink changes that.
“Make Event Sourcing in Go as simple as using a traditional ORM, while maintaining the flexibility that Go developers expect.”
✨ Features
| Feature | Status | What You Get | |
|---|---|---|---|
| 🎯 | Event Store | ✅ v0.1.0 | Append-only storage with optimistic concurrency |
| 🔌 | Adapters | ✅ v0.1.0 | PostgreSQL & In-Memory adapters |
| 🧱 | Aggregates | ✅ v0.1.0 | Base implementation with event application |
| 🧪 | Testing | ✅ v0.1.0 | 90%+ coverage, Docker Compose infrastructure |
| 📋 | Command Bus | ✅ v0.2.0 | Full CQRS with middleware, validation & idempotency |
| 🔐 | Idempotency | ✅ v0.2.0 | Prevent duplicate command processing |
| 🔗 | Correlation/Causation | ✅ v0.2.0 | Distributed tracing support |
| 📖 | Projections | 🔜 v0.3.0 | Inline, async, and live read models |
| 🛠️ | CLI | 🔜 v0.4.0 | Generate code, run migrations, diagnose issues |
| 🔐 | Security | 🔜 v0.5.0 | Field-level encryption & GDPR compliance |
| 🔄 | Sagas | 🔜 v0.5.0 | Coordinate long-running business processes |
| 📤 | Outbox | 🔜 v0.5.0 | Reliable event publishing |
🚀 Quick Start
package main
import (
"context"
"github.com/AshkanYarmoradi/go-mink"
"github.com/AshkanYarmoradi/go-mink/adapters/postgres"
)
func main() {
ctx := context.Background()
// 🔌 Connect to your database
store, _ := mink.NewEventStore(
postgres.NewAdapter("postgres://localhost/orders"),
)
// 📦 Create an aggregate
order := NewOrder("order-123")
order.Create("customer-456")
order.AddItem("SKU-001", 2, 29.99)
// 💾 Save events automatically
store.SaveAggregate(ctx, order)
// 📖 Projections update in real-time
store.RegisterProjection(&OrderSummaryProjection{})
}
That’s it. No ceremony. No configuration hell. Just clean, idiomatic Go.
📦 Installation
# Install the library
go get github.com/AshkanYarmoradi/go-mink
# Install PostgreSQL adapter
go get github.com/AshkanYarmoradi/go-mink/adapters/postgres
# Or use in-memory adapter for testing
go get github.com/AshkanYarmoradi/go-mink/adapters/memory
📚 Documentation
Getting Started
| Guide | Description |
|---|---|
| 📘 Introduction | Why go-mink exists and what problems it solves |
| 🏗️ Architecture | Core concepts and system design |
| 💾 Event Store | How events are stored and retrieved |
| 📖 Read Models | Building and maintaining projections |
Advanced Topics
| Guide | Description |
|---|---|
| 🔌 Adapters | Database adapters and custom implementations |
| ⚡ Commands & Sagas | CQRS command bus and process managers |
| 🔐 Security | Encryption, GDPR, and event versioning |
| 🧪 Testing | BDD fixtures and debugging tools |
Reference
| Guide | Description |
|---|---|
| 🛠️ CLI Reference | All command-line tools |
| 📖 API Reference | Complete API documentation |
| 🗺️ Roadmap | What’s coming next |
Learn Event Sourcing
| Guide | Description |
|:——|:————|
| 📝 Blog Series | 8-part series on Event Sourcing & CQRS with go-mink |
🌟 Why Choose go-mink?
| Aspect | Traditional Approach | With go-mink |
|---|---|---|
| Event Storage | Custom implementation | Built-in, optimized |
| Projections | Manual, error-prone | Automatic, reliable |
| Database Support | Locked to one DB | Swap adapters anytime |
| Testing | Complex setup | BDD fixtures included |
| Learning Curve | Steep | Gentle, familiar API |
🤝 Community & Support
| 💬 | GitHub Discussions — Ask questions, share ideas |
| 🐛 | Issue Tracker — Report bugs, request features |
| 🤝 | Contributing Guide — Help us improve |
| ⭐ | Star on GitHub — Show your support |
📄 License
go-mink is open source under the Apache 2.0 License.
go-mink
Event Sourcing for Go, Done Right. 🦫