stackyrd-nano is a lightweight, modular service framework for Go built on Gin. It provides auto-discovered services, middleware, and infrastructure components — so you can focus on business logic while the framework handles wiring 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 PostgreSQL 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
- REST APIs with cursor-based pagination, request validation, structured responses
- Real-time features with built-in WebSocket hub
- Fault-tolerant services with circuit breakers, retry, and timeout patterns
# Clone the repository
git clone https://github.com/diameter-tscd/stackyrd-nano.git
cd stackyrd-nano
# Install dependencies
go mod download
# Run the application
go run cmd/app/main.go
# To build the application
go run scripts/build/build.go
# To download package
go run scripts/pkg/pkg.go
- 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.