Quick Start

go version    # Should show 1.22 or later
node --version # Should show 18 or later
mizu version   # Should show the installed Mizu CLI version

mizu new --list-templates frontend

mizu new ./my-app --template frontend/react

mizu new ./my-app --template frontend/htmx

cd my-app

my-app/
├── cmd/
│   └── server/
│       └── main.go          # Entry point
├── app/
│   └── server/
│       ├── app.go           # Mizu app setup
│       ├── config.go        # Configuration
│       └── routes.go        # API routes
├── frontend/                  # Frontend code
│   ├── src/
│   │   ├── main.tsx         # Entry point
│   │   ├── App.tsx          # Root component
│   │   └── ...
│   ├── package.json
│   └── vite.config.ts       # Vite configuration
├── dist/                    # Built frontend (after build)
├── go.mod
└── Makefile                 # Common commands

my-app/
├── cmd/
│   └── server/
│       └── main.go          # Entry point
├── app/
│   └── server/
│       ├── app.go           # Mizu app setup
│       ├── config.go        # Configuration
│       ├── routes.go        # Routes
│       └── handlers.go      # Request handlers
├── views/                   # HTML templates
│   ├── layouts/
│   │   └── default.html
│   └── pages/
│       ├── home.html
│       └── about.html
├── static/                  # CSS, JS, images
│   ├── css/
│   └── js/
├── go.mod
└── Makefile

make dev

# Terminal 1: Start frontend dev server
cd frontend
npm run dev

# Terminal 2: Start Go backend
go run cmd/server/main.go

make dev

go run cmd/server/main.go

package server

import (
    "embed"
    "io/fs"

    "github.com/go-mizu/mizu"
    "github.com/go-mizu/mizu/frontend"
)

//go:embed all:../../dist
var distFS embed.FS

func New(cfg *Config) *mizu.App {
    app := mizu.New()

    // Your API routes
    setupRoutes(app)

    // Frontend middleware (auto-detects dev/prod)
    dist, _ := fs.Sub(distFS, "dist")
    app.Use(frontend.WithOptions(frontend.Options{
        Mode:        frontend.ModeAuto,           // Auto-detect
        FS:          dist,                         // Embedded production files
        DevServer:   "http://localhost:" + cfg.DevPort, // Dev server
        IgnorePaths: []string{"/api"},            // Don't proxy API routes
    }))

    return app
}

func setupRoutes(app *mizu.App) {
    // Example API endpoint
    app.Get("/api/hello", func(c *mizu.Ctx) error {
        return c.JSON(200, map[string]string{
            "message": "Hello from Mizu!",
        })
    })
}

function App() {
    const [message, setMessage] = useState('');

    useEffect(() => {
        // Call the Go backend API
        fetch('/api/hello')
            .then(res => res.json())
            .then(data => setMessage(data.message));
    }, []);

    return (
        <div>
            <h1>{message}</h1>
        </div>
    );
}

# Install air
go install github.com/cosmtrek/air@latest

# Run with auto-reload
air

make build

# Set production mode
export MIZU_ENV=production

# Run the server
./bin/server

MIZU_ENV=production ./bin/server

func setupRoutes(app *mizu.App) {
    app.Get("/api/hello", handleHello)
    app.Get("/api/users", handleUsers)  // New endpoint
}

func handleUsers(c *mizu.Ctx) error {
    users := []map[string]any{
        {"id": 1, "name": "Alice"},
        {"id": 2, "name": "Bob"},
    }
    return c.JSON(200, users)
}

// In your React component
useEffect(() => {
    fetch('/api/users')
        .then(res => res.json())
        .then(data => setUsers(data));
}, []);

cd frontend
npm install <package-name>

go get <package-name>

make clean

# Frontend tests
cd frontend
npm test

# Backend tests
go test ./...

type Config struct {
    Port    string  // Change to "3001"
    DevPort string
    Env     string
}