hello_app

A more streamlined version of the hello example using the application framework with dependency injection.

Source Code

Path: examples/hello_app/

const std = @import("std");
const tk = @import("tokamak");

const App = struct {
    server: tk.Server,
    routes: []const tk.Route = &.{
        .get("/", hello),
    },

    fn hello() ![]const u8 {
        return "Hello, world!";
    }
};

pub fn main() !void {
    try tk.app.run(tk.Server.start, &.{App});
}

Features Demonstrated

• Application framework (tk.app)
• Dependency injection container
• Declarative server configuration
• Automatic memory management
• Clean, minimal boilerplate

How It Works

The tk.app.run() function:

1. Creates a dependency injection container
2. Initializes all services defined in App
3. Calls the entry function (tk.Server.start)
4. Handles cleanup on shutdown

Running

cd examples/hello_app
zig build run

Visit http://localhost:8080/ to see the greeting.

Comparison with hello

This example is functionally identical to hello but uses the app framework, which:

• Eliminates manual allocator setup
• Automatically manages the server lifecycle
• Provides a cleaner, more declarative API
• Is the recommended approach for Tokamak applications

Next Steps

• See blog for a full application with services and middleware
• Check out todos_orm_sqlite for database integration