Mono

A full-stack boilerplate combining a Go backend with a React 19 frontend, designed to run as a web application, SPA server, or native desktop application using webview.

Features

• React 19 with Material-UI v7 and Vite 7
• Go backend with JWT authentication and embedded frontend
• Dual deployment: Web server or native desktop window
• Modern tooling: ES modules, code splitting, hot reload
• Zero configuration: Embedded assets, single binary output

Tech Stack

Frontend: React 19, MUI v7, Vite 7, Emotion, React Router
Backend: Go, Gorilla Mux, JWT, embedded FS, webview, leveldb

Requirements

Mono is tested on Ubuntu 24.04. You need:

• Go 1.21+
• Node.js 20.19+ or 22.12+
• Webview system libraries:

sudo apt install pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev

Cross-compiling Windows binary from Ubuntu 24.04

To build a native Windows .exe from Ubuntu 24.04 using MinGW and CGO:

Install MinGW toolchain:

sudo apt install mingw-w64 mingw-w64-common mingw-w64-i686-dev mingw-w64-x86-64-dev

Build the Windows binary (WebView UI enabled):

CGO_ENABLED=1 GOOS="windows" GOARCH="amd64" CC="x86_64-w64-mingw32-gcc" CXX="x86_64-w64-mingw32-g++" go build -ldflags="-H windowsgui"

Alternatively, from a checked-out project you can run the helper script (make it executable once if needed):

chmod +x windows-build   # once, if needed
./windows-build

If you hit a WebView2 EventToken.h error from github.com/Ghibranalj/webview_go like:

# github.com/Ghibranalj/webview_go
.../WebView2.h:978:10: fatal error: EventToken.h: No such file or directory

create a case-sensitive symlink for the header in the MinGW include directory:

sudo ln -s /usr/x86_64-w64-mingw32/include/eventtoken.h /usr/x86_64-w64-mingw32/include/EventToken.h

Quickstart

Note: Vite 7 requires Node.js 20.19+ or 22.12+.

One-liner (recommended)

From an empty directory:

curl -s https://raw.githubusercontent.com/benitogf/mono/master/use.sh | bash

This will:

• Download the master branch zip
• Extract it and move the contents into the current directory
• Run npm install and npm run build if npm is available

Manual setup

# Download and extract into current directory (preserve repo structure)
wget https://github.com/benitogf/mono/archive/refs/heads/master.zip -O mono-master.zip
unzip mono-master.zip
rm mono-master.zip
mv mono-master/* .
rmdir mono-master

# Install frontend dependencies
npm install

# Build frontend
npm run build

# Run as web application (API + embedded SPA on spaPort)
go run main.go -ui=false

# Run as desktop application (opens webview window pointing to SPA)
go run main.go -ui=true

# Build single binary
go build
./mono

Development

# Frontend dev server (hot reload)
npm start

# Backend dev server
go run main.go -ui=false -port=8888

Related Projects

Part of the ooo ecosystem:

• ooo - Main server library
• ko - Persistent storage adapter
• ooo-client - JavaScript client
• auth - JWT authentication