Nguyen.go — Next.js for Go

Full-stack Go framework for modern web. Write both frontend and backend in Go, compile frontend to WebAssembly, deploy a single binary.

Highlights

Rendering & Frontend:

• File-based routing like Next.js (file .gox = one route)
• React-style hooks written in Go: UseState, UseEffect, UseQuery, UseMutation...
• SSR / ISR / CSR + Streaming SSR
• Islands architecture — only hydrate interactive parts
• HMR, image optimization (WebP/AVIF), PWA, per-route code splitting
• GEO (SEO for AI) — auto-generate llms.txt, sitemap, JSON-LD

Backend (new in v1.0.7):

• Database layer — query builder, transaction, migration system
• Auth — JWT, refresh token, bcrypt, session, OAuth2 (Google, GitHub, Facebook)
• CSRF protection — token auto-rotate, constant-time validation
• Validator — 13+ rules, struct tag + map validation, Fiber middleware
• File upload — local + S3, MIME filtering, single/multiple handlers
• WebSocket — hub, rooms, broadcast, send-to-client
• i18n — JSON translations, nested keys, auto locale detection
• Mail — SMTP/TLS, HTML templates, attachments
• Event bus — sync/async, decouple business logic
• Rate limit per-endpoint
• Docker — multi-stage build, compose (app + PostgreSQL + Redis)

CLI:

nguyen create # Scaffold project

nguyen dev # Dev server + HMR

nguyen build # Compile .gox → WASM + static HTML

nguyen start # Production server

nguyen export # Static pre-render for CDN

nguyen migrate # Database migrations (up/down/create/status)

Quick example

---

import "nguyen.go/pkg/core"

count, setCount := core.UseState("count", 0)

func increment() {

setCount(count + 1)

}

---

<h1>Count: {count}</h1>

<button @click="increment()">+1</button>

Backend API

app := nguyen.New(

nguyen.WithPort(3000),

nguyen.WithPages("pages"),

nguyen.WithDatabase(config.DatabaseConfig{

Driver: "postgres",

DSN: "postgres://user:pass@localhost/mydb?sslmode=disable",

}),

nguyen.WithAuth(config.AuthConfig{Enabled: true, JWTSecret: "secret"}),

nguyen.WithSetup(func(f *fiber.App) {

api := f.Group("/api")

api.Post("/login", server.RateLimit(5, time.Minute), loginHandler)

api.Get("/me", app.Auth().Required(), meHandler)

}),

)

app.Events().On("user.registered", func(payload interface{}) {

app.Mailer().SendTemplate([]string{user.Email}, "Welcome!", "welcome", user)

})

app.Listen(":3000")

Requirements

• Go 1.25+
• TinyGo (optional, for client-side WASM)

Installation

go install github.com/dev2k6/Nguyen.go/cmd/nguyen@latest

nguyen create my-app

nguyen dev

Links

• GitHub: