Skip to main content
Learn Mizu through practical, runnable examples. Each example focuses on one concept and includes complete, working code. All examples are available at github.com/go-mizu/examples:
git clone https://github.com/go-mizu/examples
cd examples
go run ./001-hello-mizu

Getting Started

These examples cover the fundamentals of building web applications with Mizu:
  1. Hello, Mizu - Your first web server
  2. Static Files - Serve HTML, CSS, and JavaScript
  3. Routing Basics - Define routes and handlers
  4. JSON Responses - Return structured data
  5. Context and Lifecycle - Handle timeouts and cancellation
  6. Query, Form, and Path Parameters - Read request data
  7. Cookies - Store data between requests
  8. Middleware Basics - Add logging, auth, and shared logic
  9. Error Handling and Recover - Handle errors and panics
  10. Logging with slog - Structured request logging

What you will learn

By working through these examples, you will understand how to:
  • Create routes and handlers
  • Read data from requests (path, query, form, JSON)
  • Send responses (text, JSON, HTML, files)
  • Use middleware for cross-cutting concerns
  • Handle errors consistently
  • Log requests and application events
Start with Hello, Mizu and work through each example in order.