gogogofullstacktemplate

package module
v0.63.0 Latest Latest
Warning

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

Go to latest
Published: Nov 8, 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.

Every web project starts with the same conversation β€” pick a database, auth, router, reactive frontend, task queue… β€” and the project stalls at the decisions, installations, and configurations. Not at the code. This template answers those decisions once, ships them wired together, and documents how to change or remove each piece.

What it is not: a framework. Frameworks call your code and keep you on their release train; gogogo hands you wired, documented code and gets out of the way.

πŸ“– Docs (single source of truth)

The manual lives on the site, not in this file: calionauta.github.io/gogogo/docs/

Page index

Generated from the docs site manifest (site/docsite.config.mjs) β€” edit the manifest, then make docs-index; make check-docs fails when this block drifts.

Get started

  • overview β€” What gogogo is, who it is for, and the seven async layers it ships.
  • motivation β€” The thesis behind the stack: Go for almost everything, Zig as the named exception, and how to choose without hype.
  • architecture-decision β€” The flat-stack decision record: what it serves, what it replaced, and the migration it completed.
  • inspirations β€” What gogogo learned from other projects, credited rather than vendored.
  • getting-started β€” Clone, run, first five minutes, and the commands you need.

Agents

  • cli β€” The installer as scriptable commands: advise, preview, apply, add, check.
  • mcp β€” Install the MCP server, wire it into your client, and the tools it serves: opinions, trim, drift, migration.

Core

  • service-layer β€” Transport-free domain service: one rule per frontend fact, the recipe contract for features with writes, and the check-flatdeps gate.
  • architecture β€” Directory layout, dependency direction, entry points, and route wiring gotchas.
  • stack-layers β€” Every dependency and what it buys, layer by layer.
  • stack-tradeoffs β€” What each choice rejected, what it costs to keep, and when to revisit: Turso vs SQLite vs Postgres, Datastar vs React, and the rest.
  • features β€” Every capability and its runtime opt-out.
  • search β€” The search plugin: one seam, three layers (substring, fuzzy, BM25), the runtime picker, and what trimming it leaves behind.
  • api-routes β€” Generated inventory of every API route, pinned by tests β€” the trim and hook gate that proves no route is lost.
  • unit-contracts β€” Generated card per capability: routes it registers, generated queries it calls, runtime switch, and what removing it takes.
  • no-auth-no-db-recipe β€” Recipe for stripping auth and the database out of a clone that needs neither.
  • use-cases β€” What each core, plugin, and feature is for, in business language.
  • scope-taxonomy β€” Core / Plugin / Feature: the rule for deciding what is safe to delete.
  • porting-into-an-existing-app β€” Taking one unit into an app that already exists: export, copy, rewire, prove β€” and the four things no recipe can know.
  • db-concurrency β€” Turso single-writer stance, the probed MVCC path, and revisit triggers.
  • configuration β€” Every environment variable and runtime constant.
  • rbac β€” Casbin RBAC: role vocabulary, the feature checklist, hint-vs-enforcement, and the two invariants that bite (authentication is not authorization; policy objects are paths, not regex).
  • security β€” The security map: sessions, RBAC, edge headers, step-up, secrets, audit retention, CSP reporting, supply chain, production defaults and residual risks.
  • dependency-principles β€” Write it or take the library: six principles, the ordered decision procedure, the closed human gate, and the trade-off line a reviewer reads.
  • exception-to-go β€” Go-first policy: why Zig is an exceptional native boundary, the agent decision procedure, and the isolation, testing, and removal rules.
  • native-language-tradeoffs β€” Evidence-backed tradeoffs of Zig, Rust, Nim, Odin, and Mojo as native exception languages, and what a non-Zig proposal must rebut.

Async

  • async-layers β€” The seven async layers, SSE Hub record-sync vs ephemeral signals, cross-instance and offline sync.
  • realtime-recipe β€” How to add live UI: client/server patterns, checklist, no invented transports.
  • notifications β€” The inbox slice: a DagNats sleep for the delay, one owner-scoped delivery row, and the dedupe that makes a retry safe.
  • dagnats β€” DagNats capability table, version bounds, learned gotchas, and the add-a-workflow path for LLM agents.

AI

  • llm-and-credits β€” GoAI configuration and the optional ai-credits / BYOK plugin.
  • review β€” The review loop: Genkit flows, goai generation, and a Jev-compatible classifier judge.
  • native-panels β€” Adding a native Chat panel: the provider contract, hydration, in-place actions, and the reuse rule β€” render the feature's own components, never a chat copy.

Frontend

  • todo-example β€” The Todo reference implementation and the contract to imitate.
  • ui-shell β€” The shell anatomy, the page kit, and what a page owns.
  • ui-compositions β€” The approved compositions β€” account row, preference row, join, empty state, stack key β€” the markup to copy instead of inventing.
  • ui-themes β€” The one shell, DaisyUI, and the theme catalog.
  • ui-sounds β€” Vendored cuelume sound feedback and its accessibility contract.

Research

  • research β€” One place for every research note, comparison and tradeoff decision in this repo: what was evaluated, when, and what was chosen.
  • skill-reading-policy β€” Whole vendored skill or component sections? A two-arm measurement: the full read cost +36% tokens and +74% wall clock with identical markup and gates.
  • daisyui-vocabulary-source β€” Where a linter's vocabulary lives: authored map versus derived snapshot, the 2026 drift-check evidence, and why daisyui-lint embeds one.
  • auth-libraries β€” The 2026-10-21 evaluation of limen against owning argon2id and sessions: schema ownership, version skew, and what flips the decision.
  • desktop-auth-sync β€” License gate, account pairing or cloud-only? The 2026 desktop distribution options, the offline-first matrix, and why gogogo keeps one identity per profile.
  • ui-engine-research β€” The 2026-10-21 engine and component-library evaluation behind the UI stack, with local benchmarks and the Rocket assessment.
  • ui-components β€” The 2026-10-21 comparison of DaisyUI, Starbase, datastar-ui and dsx on Datastar, SSE, lightness, performance, functionality and forkability.
  • supply-chain-scanning β€” The 2026-10-24 SBOM/image-scanning comparison: Syft+Grype against Trivy, Docker Scout and OSV-Scanner, with the pinned-action and fixable-high gate.
  • native-kernels β€” The 2026-10-25 native-kernel PoCs: FNV-1a tie vs grayscale survivor, SIMD verbs audit, loader prices, Rust/Odin probes.
  • browser-automation β€” chrome-headless-shell vs Lightpanda vs happy-dom vs remote CDP on a shared 8 GB box, and why a Playwright suite's lifecycle, not its engine, is what took the host down.
  • notify β€” The 2026-10-27 notify evaluation: what to copy from a delivery engine, why the inbox stays local, and where an external provider fits.
  • ci-wall-clock β€” Where CI's minutes go, measured per job and per package: sharding by cost, PR-only test selection, narrow caches, and the options that were rejected with evidence.
  • ci-playbook-boardy β€” Owen Gretzinger's nine CI levers cross-checked against this repo: eight already shipped, the paid runner rejected, and the live gap β€” an untested docs-only skip classifier that can report green while skipping every heavy gate.
  • ci-provider-move β€” CircleCI, Dagger, Woodpecker and self-hosted evaluated against measured numbers: minutes are free on a public repo, the runner queue is 12s, and more cores cannot beat a 42s package tail β€” a provider move is cost without wall-clock.
  • mobile-android β€” The 2026-10-30 Android spike: tursogo has no Android library, ncruces keeps SQL and migrations shared, cmd/gui chose ncruces explicitly, and cmd/mobile is the separate entrypoint.
  • android-spike β€” The Android spike build log: commands, driver matrix, libc shims, system-bar insets, screenshots, disk usage and cleanup.
  • scaffold-choice β€” Why the scaffold prompt offers only the installer units, the three lists that disagree, and the Scaffold class that makes every capability an explicit keep-or-drop.
  • extensibility β€” Core plus installable extensions evaluated for 2026: why buildmode=plugin is out, why anchor-patching cannot carry N authors, what compile-time registration costs, and the ordered spikes that can kill the idea.
  • i18n β€” UI internationalization: own the seam on the text package, rent CLDR depth only on a trigger. The libraries evaluated, mitigations for their gaps, and the phased, deletable plan.

Ship

  • deploy β€” Server layout, first-time setup, deploy workflow, build pipeline and version badge.
  • desktop-mobile β€” Wails v3 desktop/mobile, edge sync, and the native window.
  • admin-dashboard β€” Admin surfaces, the single-cookie session, and the DagNats console.

Operate

  • upgrading β€” Keeping a scaffolded project current: the recorded base revision, --check-update's two halves, and migrate as a list plus gates β€” never a merge.
  • local-ci β€” The five-tier feedback loop and make signoff.
  • ci-triage β€” When CI fails on something variable: the 60-second triage, flake diagnosis, quarantine with an expiry, and why 100% is not the target.
  • code-quality β€” The linter set, how to scope it, the Datastar-specific rules, and the ruleguard rules that encode project footguns as CI failures.
  • troubleshooting β€” Symptoms and where they actually come from.
  • duckdb β€” Query JSONL logs and the Turso file with DuckDB: local operator recipe.
  • doctor-generate β€” Doctor (read-only preflight, JSON for agents) and deterministic generate (templ+sqlc+css+docs) β€” the LLM-era determinism layer.

Plus ARCHITECTURE.md β€” the canonical annotated dependency graph, and AGENTS.md β€” the working rules for human and AI agents in this repo. The rules an agent is meant to load live in skills/gogogo-coding-standards (Go + template standards, concurrency, perf, testing, the exception-to-go gate) β€” install it with npx skills add calionauta/gogogo.


πŸš€ Quick start

This repo is a GitHub template β€” click Use this template to get your own copy, then rename it. Do not build inside a clone of the template itself: your module path would stay github.com/calionauta/gogogo and deploys would target the template's server directory.

# 1. Scaffold with the installer: one command installs (binaries +
#    Go toolchain when missing), asks name/owner/plugins/features, renames,
#    trims what you skip, writes AGENTS.md, then `make dev` takes this
#    terminal β€” Ctrl-C stops dev. Needs curl + git, nothing else.
curl -sSfL https://raw.githubusercontent.com/calionauta/gogogo/master/install.sh | sh -s -- --run

# With Go already installed, the equivalent without curl|sh:
# go run github.com/calionauta/gogogo/cmd/gogogo@latest --run

# Manual fallback (no installer):
# gh repo create my-app --template calionauta/gogogo --clone
# cd my-app
# make rename NAME=my-app          # add OWNER=myorg if not under calionauta
# make site                        # regenerate the published docs
# make dev                         # run

This command needs Go and git (checked up front) β€” or curl + git via the binary install in CLI & MCP below, where install.sh bootstraps Go when missing. Open http://localhost:8080 for the landing page, then http://localhost:8080/todo for the demo (sign in with the seeded demo1@demo.app / demo1234456; demo2@demo.app takes the same password for two-user contention).

make rename only rewrites this project's identity. Sibling repos under the same owner (ai-credits, datastar-lint, pi-leakguard) are real dependencies and are left alone.

One make build compiles everything. No build tags, no feature matrix. Opt out at runtime with env vars (NATS_ENABLED=false, DAGNATS_ENABLED=false).

In the box

Layer Choice Why
Language Go 1.27 Fast compilation, easy deploy, lean runtime. Go-first: Zig only as an exceptional native escape hatch (exception-to-go; the why: motivation)
Zero-config database and auth Turso Database (SQLite-compatible, sqlc) + owned argon2id sessions Zero-config Turso, cookie sessions, file-local storage β€” no separate service
Access control without a service Casbin + users.role Roles on the user row, policy in one model, enforced before the handler; embedded policy by default, DB-backed when evolving (rbac)
Security you can audit Owned auth + security_events + CSP reporting Sessions, credential/admin step-up, role changes and rejected logins leave a durable trail; /config shows 24h aggregates and exports CSV (security)
Reactive UI with no JS framework Templ + Datastar (SSE) + Tailwind v4 Server-rendered HTML, ~12 KiB client, no JS framework build step
One shell, switchable themes DaisyUI v5 + four palettes One markup for every page; the theme picker swaps palette and radius, never layout
Diagrams without a charting stack Pele (vendored, Mermaid syntax) A mermaid fence in a chat answer becomes themeable SVG in the browser β€” no Mermaid.js, no build step, and the source still reads as code without the script
Background jobs with retry goqite + SSE Hub goqite executes with backoff; SSE Hub streams progress to the browser. No Redis
Workflows that survive a restart DagNats Multi-step workflows as declarative JSON; resume after a mid-run kill
Room ownership without races GoAkt One grain per room: heartbeat roster plus exactly-one presenter lock, supervised
Shared state that merges offline edits Loro CRDT + Rough.js Conflict-free state with no last-write-wins data loss
Realtime for one instance or many SSE Hub + NATS JetStream Per-user record push, plus cross-instance broadcast β€” including a collaborative presence roster that is the union of instances, not a per-pod count
AI features on any provider GoAI + optional ai-credits Any OpenAI-compatible provider; optional billing ledger + BYOK
Secrets encrypted at rest age + ~/.secrets/ Project-scoped local encryption. No vault, no cloud; name scoping is not a sandbox (security)
Desktop apps on the same backend Wails v3 (default) + gogpu/ui (opt-in native) + MyGo (opt-in loopback shell) + PWA-only option Native shells over the same backend, plus a no-HTTP frontend; confirm strategy with operator (see desktop-mobile.md Β§ Choosing)
Linting tuned for AI-written code golangci-lint + datastar-lint Tuned for LLM-authored code: unchecked errors, context leaks, lost context propagation
Database drivers by target

The database is Turso Database (SQLite-compatible) on the web and desktop builds. Two targets use the pure-Go ncruces/go-sqlite3 driver over the same schema and migrations:

Target Driver Why
cmd/web, cmd/desktop tursogo (turso, Turso Database) the default engine; desktop boots the same StartChi stack
cmd/gui (gogpu/ui) ncruces (sqlite3) tursogo links purego/fakecgo, which collides with goffi at CGO_ENABLED=0
cmd/mobile (Android) + its queue/ledger ncruces tursogo embeds no Android library

ncruces is a driver, not a second database: same file format, schema and migrations. The full table and reasons: stack-layers.

Full table with the reasoning behind each choice: stack-layers. Client weight per feature (measured): 0–48 KB of JS β€” the backend is the source of truth, the browser holds intent and cache.

Everything async your app will need

Seven complementary layers, already inside, each with its own opt-out:

Background jobs that update the UI   β†’ goqite + SSE Hub (always on)
Workflows that survive a restart     β†’ DagNats as JSON (DAGNATS_ENABLED=false)
Collaboration without data loss      β†’ Loro CRDT (remove internal/collab/)
Live record updates, scoped per user β†’ SSE Hub record-sync (always on)
Ephemeral UI signals                 β†’ SSE Hub via Datastar (always on)
Broadcast across instances           β†’ JetStream (NATS_ENABLED=false)
Collaborative presence (who's here)  β†’ doc frame bridge + federated roster
Room ownership without races         β†’ GoAkt grains (GOAKT_ENABLED=false)

Records flow through the SSE Hub record event β€” scoped per user by the owner column, free of charge. The ephemeral channel is reserved for ephemeral signals (toasts, client counts, workflow progress). Mixing those two up is the most common mistake in Datastar apps; async-layers explains why the split matters.

Capabilities

Every capability is always compiled. Each has a documented opt-out.

Capability Opt-out
Todo app + live record-sync, stacked toasts, sound feedback delete features/todo/
Queue + retry with exponential backoff, SSE lastRetry signal β€” (core)
AI Suggest via GoAI, or keyless simulated LLM for the demo no GOAI_API_KEY and SIMULATE_LLM=false
Chat: model renders catalog UI + invented visuals + diagrams via SSE, persisted per owner trim genui (removes Chat), or no GOAI_API_KEY and SIMULATE_LLM=false (demo answers keyless)
Review loop: writer β†’ critic β†’ classifier judge, streamed verdict trim review, or no GOAI_API_KEY (real-LLM only; page shows a setup hint)
Search layers for feature rows (substring in SQL, fuzzy tiers, BM25 over its own postings) trim search (a consumer keeps the SQL substring layer)
AI credits + BYOK relay + Stripe top-ups CREDITS_ENABLED=false
Collaborative whiteboard (CRDT + presence + offline outbox) trim whiteboard (bundle with notes + collab transport), or COLLAB_SNAPSHOTS=memory
Room presence demo (GoAkt grains: roster + presenter lock) delete features/room/
Shared notes (server-owned Loro Text, live peer text) delete features/notes/
Durable WelcomeOnboarding workflow DAGNATS_ENABLED=false
Durable offline writes (page outbox + app-shell cache + Leaf Node) OFFLINE_SYNC_ENABLED=false
Single-store persistence (Turso Database via sqlc) β€” (core)
Multi-instance realtime NATS_ENABLED=false
Public landing page + auth-gated config view delete features/landing/, features/config/
Wails v3 desktop/mobile + native window delete cmd/desktop/, cmd/gui/

Infrastructure opts out with an env var. The installer automates the common deletions β€” named presets included: go run ./cmd/gogogo --preset minimal (core + todo + auth), no-ai, no-collab β€” see cmd/gogogo/README.md. Product features also opt out by deleting the package and its one wiring call β€” see features.

Core / Plugin / Feature

Every removable piece of the template is one row in internal/capabilities, and the row declares its removal class. There is no per-file header to keep in sync: a package's class is its owning row's, and a package no row owns fails the registry's coverage test.

Class Meaning You would
core πŸ”΄ The binary does not work without it Customize, never remove
plugin 🟑 The binary works but loses a capability Swap, or delete + remove the wiring call
feature 🟒 A demo or add-on Keep as reference, then remove

The rule for agents: never delete a core row without asking; never keep a feature row in production if the domain doesn't need it. Full taxonomy and per-package removal table: scope-taxonomy.

For AI agents

Three entry points, one engine (internal/installer β€” CLI and MCP execute the same code path with the same receipts and proof):

  • llms.txt β€” the agent entry index: what to read per task, invariants to not relearn. Published map of the docs site: site/llms.txt (index) + site/llms-full.txt (complete texts).
  • Installer CLI β€” go run ./cmd/gogogo advise --need "..." for opinions (reads nothing, changes nothing; --intent turns the opinion into the ordered commands for a goal), --preset minimal|no-ai|no-collab or --plugins/--features keep lists + --dry-run to preview, to take one into a tree that is not gogogo (read-only bundle + porting checklist), gogogo new feature <name> to scaffold one feature with wiring + gates + proof. Full reference: cmd/gogogo/README.md.
  • MCP server β€” cmd/gogogo-mcp (separate module, stdio): the same engine as export, new feature. The served surface, with parameters, is the table in cmd/gogogo-mcp/README.md; that module's test asserts it against the catalog, which is why this line names no list to drift. Tool table in cmd/gogogo-mcp/README.md.

Try it live

What URL
Todo & Whiteboard demo gogogo.calionauta.com
Durable workflow console (DagNats) gogogo.calionauta.com/dagnats/

Sign in as demo1@demo.app / demo1234456 (demo2@demo.app takes the same password β€” open a second browser or incognito window to be both at once and prove contention, shared-vs-private todos, and authorship).

Commands

make dev           # Live reload with Air (regenerates templ + CSS)
make build         # Build binary (unified: everything included)
make ci-local      # Full local gate (= CI): templ, lint, checks, build, boot smoke, parallel fan-out (race + browser smokes)
make signoff       # ci-local + gh signoff stamp β€” the recommended pre-push gate
make setup         # Activate lefthook git hooks + verify agent tooling
make site          # Rebuild the docs site from docs/*.md

Full command reference: getting-started.

CLI & MCP (agent paths)

Humans get the guided installer above. Agents get the same engine (internal/installer) through two scripted paths β€” opinions first, preview second, mutation last. Full guides live in their own section: docs/cli.md and docs/mcp.md.

Path Use when Entry point
advise deciding what to keep (use-case β†’ keep/drop + off-switches + Go/Zig rule). Changes nothing go run ./cmd/gogogo advise --need "..." --format json
trim --dry-run previewing the scaffold as one JSON document --no-tui --dry-run --format json (add --yes to apply)
MCP server tool calls instead of shell (advise_stack, capabilities_list, trim_plan, trim_apply, check_tree, version_status, migrate_plan, export_unit, new_feature) cmd/gogogo-mcp (own module, stdio) + one JSON block in the client config

Destructive paths refuse without explicit confirmation (--yes / confirm:true). Strategy and the foreign-codebase boundary: getting-started Β§0b–0c.

Lifecycle: create β†’ evolve β†’ update β†’ customize

The same questions come back after the scaffold, and each one has a command. The read-only ones are marked; the rest mutate exactly the tree you point them at.

Goal Command Changes anything?
Create gogogo --dry-run then --yes (interactive, or --preset/--plugins/--features) Yes β€” the new directory
Evolve: your own slice gogogo new feature <name> --dir . Yes β€” inside your tree
Update: is there anything? gogogo --check-update --dir . No. Exit 3 means yes
Update: what changed? gogogo migrate --dir . No β€” a list you apply
Update: which files apply to me? gogogo migrate --dir . --files No β€” labels each upstream file with its capability and whether you kept its unit
Customize edit freely, then gogogo --check --dir . No β€” reports whether a marker moved; your edits win
Take a unit into a non-gogogo app gogogo export <unit> --to <scratch> + porting checklist Only the scratch directory, and the bundle is stamped with the release it came from

Agents get the same answers as an ordered route: advise --intent update|port|new-feature|scaffold prints the exact commands for this tree (and refuses to name a command the tree would reject). Details: upgrading, porting, scope taxonomy.

No Go on this machine? Tagged releases ship static binaries (gogogo + gogogo-mcp, checksummed) β€” and install.sh bootstraps a user-space Go toolchain when none is found (~/.local/go, no sudo, existing installs untouched). It does not symlink go into ~/.local/bin: that directory is on your PATH, so the link would win over a system Go. It exports ~/.local/go/bin for the install and prints the line to persist it. Same one-liner as the quick start above (it is the quick start β€” append anything after --run and it reaches gogogo):

Before you push

make ci-local locally is the same gate CI runs, and make signoff adds a git stamp. It catches ~95% of regressions in under 3 minutes instead of waiting on a CI round trip. The tier ladder (T1 format/build β†’ T5 signoff) and what each tier catches: local-ci.

Contributing

The most valuable contribution right now is using gogogo for a real project and reporting what broke β€” see CONTRIBUTING.md.

AI-assisted contributions are welcome, with a human in the loop: disclose tool use in the PR body (no AI trailers in commits or changelogs), explain motivation, include a reproduction, keep the diff minimal, and run make signoff before pushing. Please discuss features in an issue before opening a PR.

Acknowledgements

Inspired by northstar by Zangster β€” a Go + NATS + Datastar + Templ + DaisyUI application starter. See docs/inspirations.md for full credits and learnings.

License

MIT β€” see LICENSE. Open to feedback, PRs, and adaptations. If something doesn't make sense, if the stack doesn't fit your problem, or if you have a better idea, open an issue.

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
_extensions
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.
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
Credits engine boot, split from the composition root.
Credits engine boot, split from the composition root.
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