> ## 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.
# Tutorial
> Build a server-rendered website
In this tutorial, you'll build a simple blog with pages, a layout, and styling. Server-rendered websites are great for content sites, blogs, and applications where SEO matters. The server generates complete HTML pages, which makes your site fast to load and easy for search engines to index.
## Step 1: Create the Project
```bash theme={null}
mizu new myblog --template web
cd myblog
go mod tidy
mizu dev
```
Open `http://localhost:8080` to see the default page.
## Step 2: Update the Layout
Edit `views/layouts/main.html`:
```html theme={null}
{{.Title}} | My Blog
{{template "content" .}}
```
## Step 3: Create a Blog Post Handler
Create `handler/posts.go`:
```go theme={null}
package handler
import "github.com/go-mizu/mizu"
type Post struct {
ID string
Title string
Summary string
Content string
Date string
}
var posts = []Post{
{
ID: "1",
Title: "Getting Started with Mizu",
Summary: "Learn how to build web apps with Mizu",
Content: "Mizu is a lightweight web framework for Go...",
Date: "January 15, 2024",
},
{
ID: "2",
Title: "Building APIs",
Summary: "Create REST APIs quickly",
Content: "Building APIs with Mizu is straightforward...",
Date: "January 10, 2024",
},
}
func PostList() mizu.Handler {
return func(c *mizu.Ctx) error {
return c.Render("pages/posts", map[string]any{
"Title": "Blog Posts",
"Posts": posts,
})
}
}
func PostShow() mizu.Handler {
return func(c *mizu.Ctx) error {
id := c.Param("id")
for _, p := range posts {
if p.ID == id {
return c.Render("pages/post", map[string]any{
"Title": p.Title,
"Post": p,
})
}
}
return c.Text(404, "Post not found")
}
}
```
## Step 4: Create Post Views
Create `views/pages/posts.html`:
```html theme={null}
{{define "content"}}