Static Middleware

middleware/static serves static files through http.FileServer. When a file is missing, it does not return 404 immediately; it continues to later routes. This makes it useful with APIs and SPA fallbacks.

Install

go get github.com/duxweb/runa/middleware

Basic usage

import (
    "net/http"

    "github.com/duxweb/runa/middleware/static"
)

route.Default().Use(static.New(static.Config{
    Root: http.Dir("public"),
    Path: "/assets",
}))

A request to /assets/app.css reads public/app.css.

Allow directory index

route.Default().Use(static.New(static.Config{
    Root:  http.Dir("public"),
    Path:  "/",
    Index: true,
}))

When Index is false, directory requests ending with / skip static and continue to later routes.

Embedded file system

//go:embed public/*
var publicFS embed.FS

route.Default().Use(static.New(static.Config{
    Root: http.FS(publicFS),
    Path: "/assets",
}))

If your embed root includes the public/ prefix, pay attention to the mapping between request path and filesystem path.

SPA fallback

route.Default().Use(static.New(static.Config{
    Root: http.Dir("dist"),
    Path: "/",
}))

route.Default().Get("/*", func(ctx *route.Context) error {
    return ctx.HTML("index fallback")
})

Because static continues to later routes when a file is missing, you can add a frontend-router fallback afterward.

Config fields

Common problems

• static is not a capability Provider and does not need runa.Install.
• Missing directories or files continue to later routes.
• Large downloads, range requests, and CDN cache strategy are usually better handled by Nginx, object storage, or a CDN.