gogogofullstacktemplate

package module
v0.68.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 11, 2026 License: MIT Imports: 0 Imported by: 0

README

gogogo

gogogo

Landing page · Docs · Releases · CI

Your stack is ready. Come build. Every decision favors practical outcomes over abstract ideals. The stack optimizes for simplicity, consistency, and shipping software with minimal friction.

A Go web template: backend + frontend + DB + auth + LLM + deploy in one binary. Not a framework — wired, documented code you own and edit.

Full manual: Docs (docs/ is the source, site/ publishes it).

Quick start

Use this template to create your own copy, then rename it — don't build inside a clone of the template itself:

curl -sSfL https://raw.githubusercontent.com/calionauta/gogogo/master/install.sh | sh -s -- --run
# Open http://localhost:8080 (demo: demo1@demo.app / demo1234456)

Manual fallback: gh repo create my-app --template calionauta/gogogo --clone, then make rename NAME=my-app, make dev.

Stack (snapshot)

Go 1.27 · Templ + Datastar (SSE) + Tailwind/DaisyUI · Turso (sqlc) + argon2id sessions + Casbin RBAC · goqite + DagNats + NATS JetStream · GoAkt (rooms) · Loro CRDT (whiteboard/notes) · GoAI (any provider). One make build compiles everything; opt out at runtime with env vars.

Recipes

Product slices are recipes: copied code you own, with a receipt (.recipes/<id>.yml) recording where it came from. Install, update, and uninstall with gogogo recipe install|update|uninstall — user edits are kept (three-way via git). Reference: features/todo. Minimal installable example: _recipes/pomodoro. Contract: skills/gogogo-recipe-authoring. Taxonomy: scope-taxonomy.

For AI agents

  • llms.txt — what to read per task.
  • go run ./cmd/gogogo advise|doctor|generate|recipe|export|new feature — same evolution engine as the MCP server (cmd/gogogo-mcp). These tools are for building/evolving a checkout; a product's users and agents use the running server's routes (POST /api/ext/invoke), not the installer MCP. See docs/mcp.md.

Try it live

Commands

make dev      # live reload
make ci-local # full gate (= CI)
make site     # rebuild the docs site

Details: getting-started.

License

MIT — see LICENSE. Feedback and PRs welcome.

Documentation

Overview

Package gogogofullstacktemplate is the module root.

This file exists so the module root package is never empty: some Go toolchains treat an empty root package as a hard "no Go files" error when running `go test ./...`, which aborts the whole test gate. With this file present the root reports "[no test files]" instead.

The package name intentionally has no underscore: golangci-lint's revive linter rejects underscore-separated package names, and the module import path (github.com/calionauta/gogogo) is independent of the package name, so renaming is safe.

Directories

Path Synopsis
_recipes
pomodoro/features/pomodoro
The pomodoro recipe's own DDL, embedded in its package.
The pomodoro recipe's own DDL, embedded in its package.
pomodoro/features/pomodoro/handlers
The pomodoro recipe's HTTP slice: one page, one write.
The pomodoro recipe's HTTP slice: one page, one write.
cmd
bump-go-toolchain command
Bump the pinned Go toolchain across every file that names it.
Bump the pinned Go toolchain across every file that names it.
check-classes command
Stylesheet reading for the repo class gate.
Stylesheet reading for the repo class gate.
check-docs command
The Client weight table is measured, and every page that quotes a weight quotes it from there.
The Client weight table is measured, and every page that quotes a weight quotes it from there.
check-flatdeps command
Flat-stack dependency guard (framework-free, one SQLite driver, no cross-feature domain imports, owned sql.Open sites)
Flat-stack dependency guard (framework-free, one SQLite driver, no cross-feature domain imports, owned sql.Open sites)
check-secrets-env command
Secrets-env site guard (secret env reads stay on the rails)
Secrets-env site guard (secret env reads stay on the rails)
check-skill-frontmatter command
Reference links inside skills (part of the skill-frontmatter gate).
Reference links inside skills (part of the skill-frontmatter gate).
check-test-value command
Test-value detection: helpers that can fail, and the two verdicts.
Test-value detection: helpers that can fail, and the two verdicts.
desktop command
Command desktop builds the Wails v3 native app shell around the exact same Go backend the web app uses (goqite queue + handlers + the flat chi router).
Command desktop builds the Wails v3 native app shell around the exact same Go backend the web app uses (goqite queue + handlers + the flat chi router).
gogogo command
Command gogogo scaffolds a new project from gogogo.
Command gogogo scaffolds a new project from gogogo.
gui command
Entitlement gate for the native window.
Entitlement gate for the native window.
license command
Command license mints and inspects the offline entitlement tokens verified by internal/license.
Command license mints and inspects the offline entitlement tokens verified by internal/license.
mygo command
Command mygo is the MyGo peer shell over the exact same flat stack the web app uses.
Command mygo is the MyGo peer shell over the exact same flat stack the web app uses.
ui-registry command
The UI registry reader (agent-facing).
The UI registry reader (agent-facing).
web command
GoAkt lifecycle (room actor system)
GoAkt lifecycle (room actor system)
Single source of truth for the optional Chat decision router (JEV_ROUTER_* env).
Single source of truth for the optional Chat decision router (JEV_ROUTER_* env).
features
account/components
templ: version: v0.3.1070
templ: version: v0.3.1070
account/handlers
Authenticated account security page.
Authenticated account security page.
app
Package app provides the cross-cutting "application core" pattern for projects built on top of gogogo.
Package app provides the cross-cutting "application core" pattern for projects built on top of gogogo.
authviews
templ: version: v0.3.1070
templ: version: v0.3.1070
chat/components
Chat page signals.
Chat page signals.
chat/handlers
HTTP chat slice (conversation demo)
HTTP chat slice (conversation demo)
chat/store
Chat demo store (in-memory)
Chat demo store (in-memory)
config/components
Auth-gated read-only /config view (masked secrets)
Auth-gated read-only /config view (masked secrets)
config/handlers
HTTP config view (admin-only, secrets masked)
HTTP config view (admin-only, secrets masked)
credits
The credits Service implements the llm.Biller seam so every Chat/ChatStream call (the internal/llm choke point) is metered.
The credits Service implements the llm.Biller seam so every Chat/ChatStream call (the internal/llm choke point) is metered.
credits/handlers
HTTP credits slice (AI credits + BYOK)
HTTP credits slice (AI credits + BYOK)
dashboard/handlers
HTTP dashboard page: the host for the `dashboard.card` slot.
HTTP dashboard page: the host for the `dashboard.card` slot.
genui/components
The action catalog: what a model-authored component may offer to DO in this app.
The action catalog: what a model-authored component may offer to DO in this app.
graph
System panorama graph (canvas).
System panorama graph (canvas).
graph/handlers
graph feature (scaffolded by `gogogo new`)
graph feature (scaffolded by `gogogo new`)
graph/native
Native (gogpu/ui) twin of the graph presence source: one room as a list.
Native (gogpu/ui) twin of the graph presence source: one room as a list.
landing/handlers
HTTP landing page (public entry surface)
HTTP landing page (public entry surface)
license/handlers
Activation page for the distribution gate.
Activation page for the distribution gate.
notes
Shared notes (server-owned Loro Text) Embedded static assets for the notes feature: notes.js (textarea op wiring + SSE stream).
Shared notes (server-owned Loro Text) Embedded static assets for the notes feature: notes.js (textarea op wiring + SSE stream).
notes/components
templ: version: v0.3.1070
templ: version: v0.3.1070
notes/handlers
HTTP notes slice (server-owned Loro Text)
HTTP notes slice (server-owned Loro Text)
notifications
Notifications: in-process inbox change fan-out.
Notifications: in-process inbox change fan-out.
notifications/components
Notifications page helpers.
Notifications page helpers.
notifications/handlers
Notifications: the inbox page and its actions.
Notifications: the inbox page and its actions.
onboarding
DagNats onboarding workflow (durable run + stepper fan-out)
DagNats onboarding workflow (durable run + stepper fan-out)
review/components
Review loop page signals.
Review loop page signals.
review/handlers
Review loop (Genkit + goai + jev judge).
Review loop (Genkit + goai + jev judge).
room/handlers
HTTP room slice (GoAkt presence demo)
HTTP room slice (GoAkt presence demo)
sounds
templ: version: v0.3.1070
templ: version: v0.3.1070
todo
Todo event bus (one publish, adapters per transport)
Todo event bus (one publish, adapters per transport)
todo/components
The three machinery sequences as data.
The three machinery sequences as data.
todo/handlers
Todo NATS bridge (cross-instance convergence)
Todo NATS bridge (cross-instance convergence)
todo/service
Transport-free todo domain service — one rule, every frontend.
Transport-free todo domain service — one rule, every frontend.
whiteboard
Collaborative whiteboard (Loro CRDT canvas) Embedded static assets for the whiteboard feature: rough.min.js (Rough.js hand-drawn canvas rendering) and whiteboard.js (Datastar/SSE canvas wiring).
Collaborative whiteboard (Loro CRDT canvas) Embedded static assets for the whiteboard feature: rough.min.js (Rough.js hand-drawn canvas rendering) and whiteboard.js (Datastar/SSE canvas wiring).
whiteboard/handlers
HTTP whiteboard slice (Loro CRDT canvas)
HTTP whiteboard slice (Loro CRDT canvas)
internal
auth
Account-management operations shared by the JSON API and the /account page.
Account-management operations shared by the JSON API and the /account page.
capabilities
Capability registry: single source of truth for ids, kinds, runtime switches, and owned paths (consumed by cmd/gogogo, docs, and --help).
Capability registry: single source of truth for ids, kinds, runtime switches, and owned paths (consumed by cmd/gogogo, docs, and --help).
cloudcfg
Local cloud-connection settings (sync.json, 0600).
Local cloud-connection settings (sync.json, 0600).
collab
Loro CRDT + DocStore + sync workers + presence To remove: delete internal/collab/ + features/whiteboard/ and drop the whiteboard roots from buildChiMux in internal/server/chi.go.
Loro CRDT + DocStore + sync workers + presence To remove: delete internal/collab/ + features/whiteboard/ and drop the whiteboard roots from buildChiMux in internal/server/chi.go.
components
templ: version: v0.3.1070
templ: version: v0.3.1070
dagnats
DagNats durable workflow engine To remove: delete internal/dagnats/, cmd/web/dagnats.go, features/onboarding/, features/todo/handlers/onboarding.go and the bootOnboarding call in internal/server/chi.go.
DagNats durable workflow engine To remove: delete internal/dagnats/, cmd/web/dagnats.go, features/onboarding/, features/todo/handlers/onboarding.go and the bootOnboarding call in internal/server/chi.go.
datastar
Datastar rendering helpers (RenderAndPatch, MergeSignals)
Datastar rendering helpers (RenderAndPatch, MergeSignals)
db
Application database: the one place that knows the Turso Database connection string, file layout, and pragmas.
Application database: the one place that knows the Turso Database connection string, file layout, and pragmas.
dbschema
ID and timestamp helpers shared by every store.
ID and timestamp helpers shared by every store.
delivery
Delivery transport seam.
Delivery transport seam.
delivery/notify
Delivery transport: notify (an external delivery engine).
Delivery transport: notify (an external delivery engine).
demo
Demo-user seed for fresh installs
Demo-user seed for fresh installs
desktopboot
Shared desktop/gui boot helpers — one bootstrap, every native shell.
Shared desktop/gui boot helpers — one bootstrap, every native shell.
goakt
GoAkt document-presence actor (whiteboard/notes roster).
GoAkt document-presence actor (whiteboard/notes roster).
graph
Graph panorama: reads the installed system (capabilities + recipes) and answers with a node/edge document the canvas can draw.
Graph panorama: reads the installed system (capabilities + recipes) and answers with a node/edge document the canvas can draw.
hostgate
Host gate for heavy Go tests (skip on saturated boxes)
Host gate for heavy Go tests (skip on saturated boxes)
i18n
Localization seam: embedded JSON catalogs plus resolution.
Localization seam: embedded JSON catalogs plus resolution.
icon
Vendored SVG path catalog for the Icon component.
Vendored SVG path catalog for the Icon component.
installer
Installer engine: opinionated stack guidance, reads nothing, changes nothing
Installer engine: opinionated stack guidance, reads nothing, changes nothing
instance
Stable instance identity (durable names + event origin)
Stable instance identity (durable names + event origin)
license
Offline entitlement tokens (license / account activation).
Offline entitlement tokens (license / account activation).
llm
GoAI LLM client (used by Suggest) To remove: delete internal/llm/ + features/todo/handlers/llm_suggest.go.
GoAI LLM client (used by Suggest) To remove: delete internal/llm/ + features/todo/handlers/llm_suggest.go.
llm/fakeserver
Package fakeserver provides an httptest-compatible OpenAI Chat Completions fake for end-to-end tests of the GoAI integration without burning real tokens.
Package fakeserver provides an httptest-compatible OpenAI Chat Completions fake for end-to-end tests of the GoAI integration without burning real tokens.
nats
NATS JetStream + Leaf Node + CRUD proxy Starts embedded NATS server or connects as Leaf Node.
NATS JetStream + Leaf Node + CRUD proxy Starts embedded NATS server or connects as Leaf Node.
natswire
Todo CRUD wire protocol (shared vocabulary, no framework types)
Todo CRUD wire protocol (shared vocabulary, no framework types)
observability
Observability core: structured logging (slog)
Observability core: structured logging (slog)
perf
Opt-in operator diagnostics: statsviz at /debug/statsviz and the stdlib pprof index at /debug/pprof.
Opt-in operator diagnostics: statsviz at /debug/statsviz and the stdlib pprof index at /debug/pprof.
queue
Package queue implements the background job subsystem: a goqite-backed SQLite queue, an SSE hub for streaming progress to the browser, and a worker pool that dispatches messages through a typed HandlerRegistry.
Package queue implements the background job subsystem: a goqite-backed SQLite queue, an SSE hub for streaming progress to the browser, and a worker pool that dispatches messages through a typed HandlerRegistry.
rbac
DB-backed Casbin policy source (persist.Adapter).
DB-backed Casbin policy source (persist.Adapter).
recipe
The action table: the invocable surface, as data.
The action table: the invocable surface, as data.
recipe/register
The wiring contract between installed recipe code and the composition root.
The wiring contract between installed recipe code and the composition root.
search
The BM25 layer: an inverted index in SQL, scored in Go.
The BM25 layer: an inverted index in SQL, scored in Go.
secrets
Package secrets decrypts a per-project environment file using age (https://age-encryption.org).
Package secrets decrypts a per-project environment file using age (https://age-encryption.org).
server
Flat-stack boot helpers (demo seed, TOTP key wiring).
Flat-stack boot helpers (demo seed, TOTP key wiring).
themes
The shipped theme catalog: the one list the UI, the pre-paint bootstrap and theme.js all read.
The shipped theme catalog: the one list the UI, the pre-paint bootstrap and theme.js all read.
ui
Small render helpers for the shell.
Small render helpers for the shell.
uiregistry
The UI registry schema, shared by the gate and the reader.
The UI registry schema, shared by the gate and the reader.
scripts
agehelper command
Command agehelper is a tiny stand-in for the `age` / `age-keygen` CLIs, used by bin/init-secrets when neither binary is installed.
Command agehelper is a tiny stand-in for the `age` / `age-keygen` CLIs, used by bin/init-secrets when neither binary is installed.
web
resources
Embedded static assets (CSS, JS, etc.).
Embedded static assets (CSS, JS, etc.).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL