Fuego serves static files from the static/ directory by default.
Default Configuration
Static files are served from /static URL path:
Access via:
/static/css/output.css/static/js/app.js/static/images/logo.png
Using in Templates
Reference static files in your layout:
templ Layout(title string) {
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="/docs/static/css/output.css"/>
<script src="/docs/static/js/app.js" defer></script>
</head>
<body>
<img src="/docs/static/images/logo.png" alt="Logo"/>
{ children... }
</body>
</html>
}
Configuration
fuego.yaml
static_dir: "static" # Directory containing static files
static_path: "/static" # URL path prefix
Custom Static Path
Change the URL path in fuego.yaml:
static_dir: "public"
static_path: "/assets"
/assets/* instead of /static/*.
Tailwind CSS
When using Tailwind, the file structure is:
styles/input.css - Source CSS with Tailwind directivesstatic/css/output.css - Compiled CSS (generated)
See Tailwind CSS for setup details.
For production, set cache headers to improve performance:
// In main.go or middleware
func CacheMiddleware() fuego.MiddlewareFunc {
return func(next fuego.HandlerFunc) fuego.HandlerFunc {
return func(c *fuego.Context) error {
if strings.HasPrefix(c.Path(), "/static/") {
c.SetHeader("Cache-Control", "public, max-age=31536000")
}
return next(c)
}
}
}
Development vs Production
Development
- Hot reload automatically rebuilds CSS
- No caching for quick iteration
Production
- CSS is minified
- Long cache headers
- Files served from compiled binary
Use fuego build to create a production binary that embeds static files.
Multiple Static Directories
You can serve multiple static directories:
// main.go
app := fuego.New()
app.Static("/static", "static")
app.Static("/uploads", "uploads")
app.Static("/vendor", "node_modules")
Docker Deployment
Include static files in your Docker image:
FROM golang:1.23-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o server .
FROM alpine:latest
WORKDIR /app
COPY --from=builder /app/server .
COPY --from=builder /app/static ./static
CMD ["./server"]
Next Steps
