stackyrd is an open-source, modular service framework for Go built on Echo. It provides a layered architecture with auto-discovered services, middleware, and infrastructure components - so you can focus on business logic while the framework handles wiring, observability, and lifecycle.
| Layer | What it does |
|---|---|
| Services | Business logic modules auto-registered via init(), toggled via config |
| Middleware | Pluggable HTTP middleware chain (JWT, CORS, rate-limit, audit, security headers) |
| Infrastructure | Managed clients for Redis, PostgreSQL, Kafka, MongoDB, MinIO, Grafana - with async init and health checks |
| TUI / Console | Interactive bubbletea dashboard or console fallback |
- Microservices with standardized routing, config, and observability out of the box
- Data pipelines with Kafka, batch processing, and cron scheduling
- Multi-tenant APIs with per-tenant Postgres/MongoDB connection management
# Clone the repository
git clone https://github.com/diameter-tscd/stackyrd.git
cd stackyrd
# Install dependencies
go mod download
# Run the application
go run cmd/app/main.go
# To run the CLI tools
./scripts/yrd # Linux/macOS - auto-selects dist binary
.\scripts\yrd.cmd # Windows
./scripts/yrd pkg # package manager
./scripts/yrd service # service generator
./scripts/yrd swagger # swagger docs
./scripts/yrd docker # docker builder
./scripts/yrd build # compile app
- Full Documentation - Comprehensive guides and references
- Contributing Guide - Development workflow and guidelines
Distributed under the Apache License Version 2.0. See LICENSE for full information.