framework

🚀 Framework

A minimal yet powerful web framework with builtin support for ssr html pages and SPA microfrontend splits

Features:

• Simple routing & templating (HTML/Go templates)
• Automatic microfrontend support for multiple SPAs
• 1 Go dependency: esbuild
  • Use anything esbuild supports, like TypeScript, JavaScript, JSX, TSX, and CSS
• NO NodeJS process required - no Webpack, Babel, Vite, Rollup, etc.
• Clean /templates + /app folder structure
• Autoreload when in development mode
• Optional Accompanying JavaScript library for frontend development
  • Server Sent Events handler, Router, state management, and elements

🚦 Quickstart

1. Project Structure

your-project/
├── templates/          # HTML templates & components
│   ├── base.html       # Required: Base layout
│   ├── entry.html      # Required: html snippet with js and css imports - autogenerated by esbuild on changes
│   ├── index.html      # Required: Default html page
│   ├── other.html      # "/other" route auto-registered
│   └── app.subroute.html # "/app/" subroute auto-registered for the app - an easy way to add a new SPA
├── static # bundled js files place here, you can .gitignore this
├── app/
│   └──  src/
│      └── index.ts        # Your frontend entrypoint, customize and codesplit as needed
└── main.go             # Your server

1. Get started with all the defaults:

package main

import (
	"net/http"

	"github.com/bencbradshaw/framework"
)

func main() {
	http.ListenAndServe(":2025", framework.Run(nil))
}

1. Override the defaults:

package main

import (
	"net/http"
	"os"

	"github.com/bencbradshaw/framework"

	"github.com/evanw/esbuild/pkg/api"
)

func main() {
	mux := framework.Run(framework.InitParams{
		IsDevMode: false,
		AutoRegisterTemplateRoutes: false,
		EsbuildOpts: api.BuildOptions{
			EntryPoints: []string{"./app/src/my-app.tsx"},
		},
	})
	// add your own routes, the same as you would with the default mux
	mux.Handle("/api/hello-world", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hello, World!"))
	}))
	http.ListenAndServe(":2025", mux)
}