$ show maxence-charriere/go-app
go-app is a Go framework for building progressive web applications entirely in Go via WebAssembly. The core package pkg/app implements a declarative component model (Composer/Compo) with lifecycle hooks, client-side routing, state management with observers and persistence, server-side pre-rendering, and a full PWA HTTP handler that serves the app shell, service worker, manifest, and static resources. The docs/ directory is itself a production go-app PWA that dogfoods the framework; docs/src contains the documentation site source code, and docs/web/documents contains the markdown content rendered at runtime by the wasm binary. Architecturally, the repository is a layered Go library rather than a monolith or microservice. pkg/app contains the runtime engine (engine.go, node.go, state.go, http.go) and uses build tags to separate server-side resource/HTTP handling from client-side wasm UI execution. pkg/cli is a struct-tag-driven CLI and environment configuration loader, pkg/cache provides reusable LRU and expiring cache implementations, pkg/errors adds typed and tagged error wrapping, and pkg/logs and pkg/analytics provide optional support utilities. Code generation in pkg/app/gen/html.go produces the strongly typed HTML element API and its generated tests. The primary data flow begins with Go component state and user events, which are dispatched through the engine and Context API to update the DOM via the node manager. State mutations can be persisted to localStorage, encrypted, and broadcast across browser tabs. On the server side, the Handler serves pre-rendered HTML, resolves static resources (local dirs, remote buckets, GitHub Pages), and caches proxied resources. External dependencies include Go modules for webpush, markdown parsing, UUID, and testing, plus browser APIs and Go's wasm_exec.js glue. There are no data pipelines, notebooks, or research artifacts; this is a pure application/framework repository.
The LLM identified 5 files worth highlighting for reuse:
A self-contained LRU cache implementation exposed behind a small Cache interface. It has no framework coupling and can be dropped into any Go service for bounded in-memory caching.
A TTL/expiring cache wrapper that stores items with expiration timestamps and removes stale entries. Self-contained and reusable for session stores, token caches, or any time-boxed cache in a Go application.
An enriched error type supporting typed errors, arbitrary tags, wrapping, UI-facing messages, and JSON serialization. It is independent of the framework internals and provides a portable pattern for structured error propagation in Go backends and UIs.
A declarative CLI and environment configuration framework driven by struct tags, with automatic option parsing, environment variable binding, and usage text generation. It demonstrates a clean reflection-based config-loading pattern that can be extracted into any Go project.
A fluent named-state API with observers, conditional subscriptions, expiration, localStorage persistence, optional encryption, and cross-tab broadcast via BroadcastChannel. Although it is integrated with the framework's Context type, the observer/persistence/broadcast mechanism is a strong reference pattern for reactive state management in Go wasm applications.