> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go-mizu.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Welcome to Mizu
> A lightweight, composable web framework for Go
# 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
```go theme={null}
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")
}
```
```bash theme={null}
go get github.com/go-mizu/mizu
go run main.go
# Visit http://localhost:3000
```
## Why Mizu?
No magic, no reflection, no code generation. Mizu uses Go 1.22+ ServeMux patterns and standard interfaces.
Production-ready middlewares for authentication, caching, rate limiting, and more.
Thin abstractions over the standard library. Learn it once, use it everywhere.
## Next Steps
Set up Mizu in your project.
Build your first app in 5 minutes.
Learn how App, Router, Handler, and Context work together.
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
Chat with the community and get help.
Star the repo, report issues, contribute code.