What is this?
An opinionated Go framework for building microservices fast — database support and observability (logs, traces, metrics) come built in, so you write service code instead of infrastructure glue.
An opinionated Go framework for building microservices fast — database support and observability (logs, traces, metrics) come built in, so you write service code instead of infrastructure glue.Is GoFr a framework my whole service is built on, or a library I call here and there?A framework, and a deliberately opinionated one: you structure the service around GoFr's APIs, and it takes over routing, config, middleware, datasources and observability for you.
A framework, and a deliberately opinionated one: you structure the service around GoFr's APIs, and it takes over routing, config, middleware, datasources and observability for you.How do I get my first service running?Install Go 1.26 or above, add the GoFr import to your code — Go modules fetches the dependency automatically — then run the sample app and open localhost:8000/greet to see the result.
Install Go 1.26 or above, add the GoFr import to your code — Go modules fetches the dependency automatically — then run the sample app and open localhost:8000/greet to see the result.Do I need to install anything else besides Go?No separate installs: databases and pub/sub systems plug in through GoFr's built-in datasource integrations, and each datasource gets an automatic health check.
No separate installs: databases and pub/sub systems plug in through GoFr's built-in datasource integrations, and each datasource gets an automatic health check.What's the trade-off with an opinionated framework like this?You accept its conventions and defaults rather than assembling your own stack, and while generic applications are possible, GoFr is really tuned for microservices.
You accept its conventions and defaults rather than assembling your own stack, and while generic applications are possible, GoFr is really tuned for microservices.Who is GoFr meant for?Go developers building microservices, especially ones deployed on Kubernetes, who want logging, tracing and metrics wired up from the first line of code.
Go developers building microservices, especially ones deployed on Kubernetes, who want logging, tracing and metrics wired up from the first line of code.Where can I run services built with it?The README sets no OS limits: as Go source it compiles wherever Go runs — a laptop for development, a Linux server or container in production.
The README sets no OS limits: as Go source it compiles wherever Go runs — a laptop for development, a Linux server or container in production.What does it give me out of the box beyond URL routing?Quite a lot: REST standards by default, config management, logs/traces/metrics, built-in auth plus custom middleware, gRPC, an HTTP circuit breaker, pub/sub, database migrations, cron jobs, Swagger rendering, websockets and abstracted file systems — and log levels can be changed without a restart.
Quite a lot: REST standards by default, config management, logs/traces/metrics, built-in auth plus custom middleware, gRPC, an HTTP circuit breaker, pub/sub, database migrations, cron jobs, Swagger rendering, websockets and abstracted file systems — and log levels can be changed without a restart.Why an opinionated framework instead of assembling Go libraries yourself?The stated goal is to simplify microservice development: instead of wiring logging, tracing, metrics, config and database clients by hand, GoFr bundles them with sane defaults so a service is Kubernetes-ready and observable from day one.
The stated goal is to simplify microservice development: instead of wiring logging, tracing, metrics, config and database clients by hand, GoFr bundles them with sane defaults so a service is Kubernetes-ready and observable from day one.How mature and active is the project?It's an established open-source project (Apache-2.0) started in October 2023 with roughly 20.9k GitHub stars, actively developed and taking part in Hacktoberfest to onboard contributors.
It's an established open-source project (Apache-2.0) started in October 2023 with roughly 20.9k GitHub stars, actively developed and taking part in Hacktoberfest to onboard contributors.Where can I see working example code and documentation?The repo has an examples directory with ready-to-run samples, plus GoDoc for the API reference and a dedicated GoFr documentation site with comprehensive guides.
The repo has an examples directory with ready-to-run samples, plus GoDoc for the API reference and a dedicated GoFr documentation site with comprehensive guides.Which topics is it in?microservice, tracing, http-server, opentelemetry, metrics, logging, grpc, configuration, deployment, cloud-native, web-framework, microservices
microservice, tracing, http-server, opentelemetry, metrics, logging, grpc, configuration, deployment, cloud-native, web-framework, microservices