Lakta

Why Lakta?

Automatic init ordering

Declare what your module provides and needs. The runtime resolves initialization order via topological sort — no manual wiring.

Context-carried DI

The injector lives on the context. Access any registered type from gRPC handlers, HTTP handlers, or Temporal activities with a single lakta.Invoke[T](ctx) call.

Batteries included

First-class modules for gRPC, HTTP (Fiber), PostgreSQL, OpenTelemetry, health checks, and Temporal workflows — all wired consistently.

Graceful lifecycle

Async and sync start phases run concurrently. SIGTERM triggers reverse-order shutdown with a 30-second deadline. Config hot-reload is built in.

A complete service in one file

func main() {
    if err := lakta.NewRuntime(
        config.NewModule(
            config.WithConfigDirs(".", "./config"),
            config.WithArgs(os.Args[1:]),
        ),
        tint.NewModule(),
        slog.NewModule(),
        otel.NewModule(),
        health.NewModule(),
        grpcclient.NewModule(
            grpcclient.WithName("data"),
            grpcclient.WithClient(v1.NewDataServiceClient),
        ),
        fiberserver.NewModule(
            fiberserver.WithDefaults(fiber.Config{ReadTimeout: 30 * time.Second}),
            fiberserver.WithRouter(registerRoutes),
        ),
    ).Run(); err != nil {
        os.Exit(1)
    }
}

func registerRoutes(app *fiber.App) {
    app.Get("/orders/:id", func(c fiber.Ctx) error {
        client, err := lakta.Invoke[v1.DataServiceClient](c.Context())
        if err != nil {
            return err
        }
        resp, err := client.GetOrder(c.Context(), &v1.GetOrderRequest{Id: c.Params("id")})
        if err != nil {
            return c.Status(fiber.StatusInternalServerError).JSON(fiber.Map{"error": err.Error()})
        }
        return c.JSON(resp.GetOrder())
    })
}

What’s included

Getting Started

Install Lakta, build your first service, and understand the module lifecycle.

Core Concepts

Deep dives into modules, the runtime, dependency injection, and configuration.

Module Reference

Docs for every built-in module: logging, OpenTelemetry, HTTP, gRPC, database, health checks, and Temporal.

Guides

Write a custom module, test with testkit, and walk through the full microservices example.