Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ankorstore/yokai
Simple, modular, and observable Go framework for backend applications.
https://github.com/ankorstore/yokai
backend dependency-injection framework go golang grpc-server http-server kubernetes metrics modular observability open-telemetry prometheus worker-pool yokai
Last synced: 4 days ago
JSON representation
Simple, modular, and observable Go framework for backend applications.
- Host: GitHub
- URL: https://github.com/ankorstore/yokai
- Owner: ankorstore
- License: mit
- Created: 2024-01-10T10:39:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-18T12:50:05.000Z (2 months ago)
- Last Synced: 2025-01-10T19:05:37.123Z (11 days ago)
- Topics: backend, dependency-injection, framework, go, golang, grpc-server, http-server, kubernetes, metrics, modular, observability, open-telemetry, prometheus, worker-pool, yokai
- Language: Go
- Homepage: https://ankorstore.github.io/yokai
- Size: 5.46 MB
- Stars: 535
- Watchers: 10
- Forks: 15
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Yokai
[](https://opensource.org/licenses/MIT)
[](https://go.dev/)
[](https://codecov.io/gh/ankorstore/yokai)
[](https://ankorstore.github.io/yokai/)
[](https://github.com/avelino/awesome-go)
> Simple, modular, and observable Go framework for backend applications.
* [Goals](#goals)
* [Documentation](#documentation)
* [Overview](#overview)
* [Architecture](#architecture)
* [Foundations](#foundations)
* [Extensions](#extensions)
* [Getting started](#getting-started)
* [Showroom](#showroom)
* [Contributing](#contributing)
## Goals
Building backend applications with [Go](https://go.dev/) is amazing.
But to build `production-grade` applications, you need to put in place a bunch of efforts and boilerplate code, introducing complexity not even related to the logic of your application (like dependencies wiring, configuration management, observability instrumentation, etc.).
To solve this, Yokai was created with the following goals in mind:
- `Simple`: it is easy to use, configure and test, enabling you to iterate fast and deliver quickly maintainable applications.
- `Modular`: it can be extended with the available Yokai modules, or with your own, to build evolvable applications.
- `Observable`: it comes with built-in logging, tracing and metrics instrumentation, to build reliable applications.
In other words, Yokai lets you focus on your application logic, while taking care of the rest.
## Documentation
Yokai's `documentation` is available at [https://ankorstore.github.io/yokai](https://ankorstore.github.io/yokai).
## Overview
### Architecture
- Yokai `core modules` preloads logging, tracing, metrics and health check instrumentation, and expose a private HTTP server for infrastructure and debugging needs.
- Yokai `extensions modules` can be added to enrich your application features, like public HTTP / gRPC servers, workers, ORM, etc. You can also add the [contrib modules](https://github.com/ankorstore/yokai-contrib) or your own.
- Those are made available in Yokai `dependency injection system`, on which you can rely to build your application logic.
### Foundations
Yokai was built using `robust` and `well known` Go libraries, such as:
- [Echo](https://github.com/labstack/echo) for HTTP servers
- [gRPC-go](https://github.com/grpc/grpc-go) for gRPC servers
- [Viper](https://github.com/spf13/viper) for configuration management
- [OTEL](https://github.com/open-telemetry/opentelemetry-go) for observability instrumentation
- [Fx](https://github.com/uber-go/fx) for dependency injection system
- and more.
### Extensions
Yokai's `extension system` enables you to `enrich` your application features with:
- the Yokai `built-in` modules
- the Yokai [contrib modules](https://github.com/ankorstore/yokai-contrib)
- your own modules
## Getting started
Yokai provides ready to use `application templates` to start your projects:
- for [gRPC applications](https://ankorstore.github.io/yokai/getting-started/grpc-application)
- for [HTTP applications](https://ankorstore.github.io/yokai/getting-started/http-application)
- for [worker applications](https://ankorstore.github.io/yokai/getting-started/worker-application)
## Showroom
Yokai provides a [showroom repository](https://github.com/ankorstore/yokai-showroom) with `demo applications`, ready to run, to see it in action:
- [gRPC demo application](https://github.com/ankorstore/yokai-showroom/tree/main/grpc-demo)
- [HTTP demo application](https://github.com/ankorstore/yokai-showroom/tree/main/http-demo)
- [worker demo application](https://github.com/ankorstore/yokai-showroom/tree/main/worker-demo)
## Contributing
This repository uses [release-please](https://github.com/googleapis/release-please) to automate Yokai's modules release process.
> [!IMPORTANT]
> You must provide [atomic](https://en.wikipedia.org/wiki/Atomic_commit#Revision_control) and [conventional](https://www.conventionalcommits.org/en/v1.0.0/) commits, as the release process relies on them to determine the version to release and to generate the release notes.