Welcome to Mizu

Mizu is a lightweight, composable web framework for Go that builds on the standard library’s net/http package. Like water (水, “mizu” in Japanese), it flows naturally with Go’s conventions while adding just enough structure to make web development enjoyable.

Get Started in 30 Seconds

package main

import "github.com/go-mizu/mizu"

func main() {
    app := mizu.New()

    app.Get("/", func(c *mizu.Ctx) error {
        return c.JSON(200, map[string]string{
            "message": "Hello, Mizu!",
        })
    })

    app.Listen(":3000")
}

go get github.com/go-mizu/mizu
go run main.go
# Visit http://localhost:3000

Why Mizu?

Built on net/http

No magic, no reflection, no code generation. Mizu uses Go 1.22+ ServeMux patterns and standard interfaces.

Composable Middleware

Production-ready middlewares for authentication, caching, rate limiting, and more.

Just Enough Structure

Thin abstractions over the standard library. Learn it once, use it everywhere.

Next Steps

Installation

Set up Mizu in your project.

Quick Start

Build your first app in 5 minutes.

Core Concepts

Learn how App, Router, Handler, and Context work together.

Tutorials

Step-by-step guides to build real applications.

What Can You Build?

Use Case	Description
REST APIs	Build type-safe APIs with automatic validation
Websites	Server-rendered pages with templates and static files
Real-time Apps	SSE support for live updates
Microservices	Lightweight services with health checks
Full-Stack	Go backend + React/Vue/Svelte frontend

Requirements

Go 1.22 or later (for enhanced ServeMux patterns)
Any operating system (Linux, macOS, Windows)

Join the Community

Discord

Chat with the community and get help.

GitHub

Star the repo, report issues, contribute code.

Why Mizu

​Welcome to Mizu

​Get Started in 30 Seconds

​Why Mizu?