Affected by 
README
¶
Web App Handler for Go
[!WARNING] The
webpackage is still in development. Use it at your own risk.
A golang http.Handler for serving no-build web applications with esm.sh CDN.
- Web applications are served as-is without build step.
- Transpiles TypeScript, JSX, Vue, Svelte on-the-fly.
- Built-in TailwindCSS generator.
- Static files are served from the application directory.
- Support Hot Module Replacement (HMR) for development.
Installation
go get -u github.com/esm-dev/esm.sh
Usage
Create a web server in golang that serves web application from a directory:
package main
import (
"net/http"
"log"
"github.com/esm-dev/esm.sh/web"
)
func main() {
http.Handle("GET /", web.NewHandler(web.Config{
AppDir: "/path/to/webapp",
Fallback: "/index.html", // fallback to root index.html (SPA mode)
Dev: false, // change to `true` to enable HMR
}))
log.Fatal(http.ListenAndServe(":8080", nil))
}
Create a index.html file in the webapp directory:
<!DOCTYPE html>
<html>
<head>
<title>My Application</title>
<link rel="stylesheet" href="/tailwind.css">
<script type="importmap">
{
"imports": {
"react": "https://esm.sh/react@19.2.4",
"react/jsx-runtime": "https://esm.sh/react@19.2.4/jsx-runtime",
"react-dom": "https://esm.sh/react-dom@19.2.4",
"react-dom/client": "https://esm.sh/react-dom@19.2.4/client"
}
}
</script>
</head>
<body class="flex justify-center items-center h-screen">
<div id="app"></div>
<script type="module" src="/app.tsx"></script>
</body>
</html>
Create a app.tsx file in the webapp directory:
import { createRoot } from "react-dom/client"
function App() {
return <h1>Hello, World!</h1>
}
createRoot(document.getElementById("app")).render(<App />)
Create a tailwind.css file in the webapp directory:
@import "tailwindcss";
Run the web server:
go run .
Open the web browser and navigate to http://localhost:8080.
Documentation
¶
Index ¶
- type Config
- type Handler
- func (s *Handler) ServeCSSModule(w http.ResponseWriter, r *http.Request, query url.Values)
- func (s *Handler) ServeFrameworkCSS(w http.ResponseWriter, r *http.Request, query url.Values, framework string)
- func (s *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request)
- func (s *Handler) ServeHmrWS(w http.ResponseWriter, r *http.Request)
- func (s *Handler) ServeHtml(w http.ResponseWriter, r *http.Request, filename string)
- func (s *Handler) ServeInternalJS(w http.ResponseWriter, r *http.Request, name string)
- func (s *Handler) ServeModule(w http.ResponseWriter, r *http.Request, filename string, query url.Values, ...)
- type JSWorker
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Handler ¶
type Handler struct {
// contains filtered or unexported fields
}
func NewHandler ¶
func (*Handler) ServeCSSModule ¶
func (*Handler) ServeFrameworkCSS ¶
func (*Handler) ServeHmrWS ¶
func (s *Handler) ServeHmrWS(w http.ResponseWriter, r *http.Request)
func (*Handler) ServeInternalJS ¶
Source Files
Click to show internal directories.
Click to hide internal directories.