npx claudepluginhub jackielii/structpagesComponent Overview
Component Details
README
structpages
Struct Pages provides a way to define routing using struct tags and methods. It integrates with Go's http.ServeMux, allowing you to quickly build web applications with minimal boilerplate.
Status: Alpha - This package is in early development and may have breaking changes in the future. Currently used in a medium-sized project, but not yet battle-tested in production.
Features
- 🏗️ Struct-based routing - Define routes using struct tags
- 🎨 Templ support - Built-in integration with Templ
- ⚡ HTMX-friendly - Automatic partial rendering support
- 🔧 Middleware - Standard Go middleware pattern
- 🎯 Type-safe URLs - Generate URLs from struct references
- 📦 Dependency injection - Pass dependencies to handlers via options
Installation
go get github.com/jackielii/structpages
Quick Start
Define your page structure using struct tags:
package main
import (
"log"
"net/http"
"github.com/jackielii/structpages"
)
type index struct {
product `route:"/product Product"`
team `route:"/team Team"`
contact `route:"/contact Contact"`
}
// Implement the Page method using Templ
templ (index) Page() {
<html>
<body>
<h1>Welcome</h1>
<nav>
<a href="/product">Product</a>
<a href="/team">Team</a>
<a href="/contact">Contact</a>
</nav>
</body>
</html>
}
func main() {
mux := http.NewServeMux()
_, err := structpages.Mount(mux, index{}, "/", "Home")
if err != nil {
log.Fatal(err)
}
log.Println("Starting server on :8080")
http.ListenAndServe(":8080", mux)
}
Route definitions use the format [method] path [Title]:
/path- All methods, no titlePOST /path- POST requests onlyGET /path Page Title- GET requests with title "Page Title"
Documentation
- API Reference - Complete API documentation for Mount, options, and methods
- Routing Patterns - Route definitions, path parameters, nested routes
- Supported Request Flows - How requests are dispatched to handlers and components
- Middleware - Using middleware with your pages
- HTMX Integration - Partial rendering and HTMX support
- URLFor & ID Generation - Type-safe URL and HTML id generation
- Templ Patterns - Working with Templ templates
- Advanced Features - Dependency injection, Init, dynamic Refs, type aliases
Examples
Check out the examples directory for complete working applications:
- Simple - Basic routing and page rendering
- HTMX - HTMX integration with partial updates
- HTMX RenderTarget - Standalone-function components shared across pages, with per-component data loading via
RenderTarget - Todo - Full TODO app: form actions via
ServeHTTPreturningRenderComponent(...)to re-render a sibling component (in-memory store)
Contributing
See CONTRIBUTING.md for development setup and guidelines.
License
MIT License - see LICENSE file for details.
Similar Plugins
go-web
Opinionated Go web app scaffolding with Templ + HTMX + Alpine.js + Tailwind
web-dev
Web frontend development with vanilla HTML, CSS, JavaScript, and HTMX
hono-guide
Build ultrafast web APIs and apps with Hono across any JavaScript runtime. Covers routing, Context API, 25+ built-in middleware (auth, CORS, caching, security), type-safe RPC client, Zod/Standard Schema validation, JSX rendering, streaming/SSE, WebSocket, cookie/JWT helpers, testing patterns, and deployment to Cloudflare Workers, Bun, Deno, Node.js, AWS Lambda, Vercel, Netlify, and more.
yusukebe-hono-skill
Build modern Hono web applications with AI guidance. Supports rapid API and web service development with Claude.
beagle-go
Go code review and development skills covering architecture, middleware, data persistence, concurrency, and framework-specific patterns for BubbleTea, Wish SSH, and Prometheus.
Help us improve
Share bugs, ideas, or general feedback.
