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 | What You Get | |
|---|---|---|
| 🎯 | Event Store | Append-only storage with optimistic concurrency & snapshots |
| 📖 | Smart Projections | Inline, async, and live read models that just work |
| 🔌 | Pluggable Adapters | PostgreSQL, MongoDB, Redis — or build your own |
| 🛠️ | Powerful CLI | Generate code, run migrations, diagnose issues |
| 📋 | Command Bus | Full CQRS with middleware, validation & retry |
| 🔄 | Saga Orchestration | Coordinate long-running business processes |
| 📤 | Outbox Pattern | Reliable event publishing with at-least-once delivery |
| 🔐 | Built-in Security | Field-level encryption & GDPR compliance tools |
| 📊 | Event Versioning | Schema evolution with automatic upcasting |
| 🧪 | Testing First | BDD fixtures & time-travel debugging |
🚀 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 the CLI (optional but recommended)
go install github.com/AshkanYarmoradi/go-mink/cmd/mink@latest
📚 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 |
🌟 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. 🦫