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 |
|---|---|
|
Package catalog is the reviewed set of recipes this template can install — entries plus the one list of which entries it recommends.
|
Package catalog is the reviewed set of recipes this template can install — entries plus the one list of which entries it recommends. |
|
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
Bare repo paths in the index pages.
|
Bare repo paths in the index pages. |
|
check-domains
command
Command check-domains is the gate for the per-slice domain cards.
|
Command check-domains is the gate for the per-slice domain cards. |
|
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-product-boundary
command
Command check-product-boundary is the "not a framework" tripwire.
|
Command check-product-boundary is the "not a framework" tripwire. |
|
check-prompts
command
Command check-prompts is the deterministic half of the prompt-as-data rule.
|
Command check-prompts is the deterministic half of the prompt-as-data rule. |
|
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-shape
command
Command check-shape is the gate for the app-shape record.
|
Command check-shape is the gate for the app-shape record. |
|
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. |
|
check-typed-states
command
Command check-typed-states is the "no stringly-typed state" gate.
|
Command check-typed-states is the "no stringly-typed state" gate. |
|
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. |
|
prompt-eval
command
Command prompt-eval reports what a candidate prompt tree changes.
|
Command prompt-eval reports what a candidate prompt tree changes. |
|
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. |
|
kiosk
The decision engine: a jev-like classifier settles the order.
|
The decision engine: a jev-like classifier settles the order. |
|
kiosk/components
The menu as a catalogue: what the counter sells, rendered as choices.
|
The menu as a catalogue: what the counter sells, rendered as choices. |
|
kiosk/handlers
The kiosk recipe's HTTP slice: one page, two POSTs.
|
The kiosk recipe's HTTP slice: one page, two POSTs. |
|
kiosk/service
The kiosk recipe's write half.
|
The kiosk recipe's write half. |
|
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. |
|
prompts
Package prompts owns every model-facing instruction as data.
|
Package prompts owns every model-facing instruction as data. |
|
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). |
|
shape
Package shape owns the one answer to "which product is this tree?"
|
Package shape owns the one answer to "which product is this tree?" |
|
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.). |
Click to show internal directories.
Click to hide internal directories.