How kush-singh-26/kosh works
Kosh is a Go static-site generator. Its principal workflow is to scan Markdown and site metadata, process assets, parse and render content, run site-wide generators, and atomically publish output; kosh serve --dev adds watching and incremental rebuilds. The map also includes persistent metadata/search/SSR caching, search-index generation and WASM querying, and the documented asset, PWA, and social features. Edges follow README build descriptions and the shown engine, worker, search-manager, and server excerpts; unsampled subsystems are represented at their existing directory paths.
Main entry points: engine.go Build engine · service.go Content service · manager.go Incremental manager · worker.go Content worker
Components 25
Build orchestration
- Build engine
builder/orchestration/engine.go - Metadata scanner
builder/services/scanner - Incremental manager
builder/orchestration/incremental/manager.go - Build filesystem
builder/fs
Content and rendering
- Content service
builder/services/content/service.go - Content worker
builder/services/content/worker.go - Markdown parser
builder/parser/parser.go - Render service
builder/services/render/render_service.go - Page renderer
builder/renderer/renderer.go
Assets and generators
- Asset service
builder/services/asset/service.go - Asset processing
builder/fs/assets.go - Site generators
builder/generators - Social cards
builder/services/content/social.go - Asset fingerprinting
builder/hashing/hash.go
Cache and search
- Cache service
builder/services/cache/cache_service.go - Metadata and SSR cache
builder/cache/store/store.go - Search index manager
builder/orchestration/search/manager.go - Search index builder
builder/generators/search.go - Search engine
builder/search/engine.go - WASM search API
cmd/search/main.go
Development serving
- Dev server
internal/server/server.go - File watcher
internal/watch/watch.go
Other components
- Site author
- Kosh CLI
cmd/kosh - Site visitor
Connections 27
- Site author → Kosh CLI: provides site
README.md - Kosh CLI → Build engine: starts build
README.md - Build engine → Metadata scanner: scans metadata
builder/orchestration/engine.go - Build engine → Asset service: builds assets
builder/orchestration/engine.go - Asset service → Asset processing: processes assets
builder/services/asset/service.go - Build engine → Content service: processes content
README.md - Content service → Content worker: dispatches work
builder/services/content/service.go - Content worker → Markdown parser: parses Markdown
builder/services/content/worker.go - Content service → Render service: renders content
builder/services/content/service.go - Render service → Page renderer: renders pages
builder/services/render/render_service.go - Build engine → Site generators: runs generators
README.md - Build engine → Build filesystem: publishes output
README.md - Content service → Social cards: generates cards
builder/services/content/service.go - Build engine → Cache service: uses cache
builder/orchestration/engine.go - Cache service → Metadata and SSR cache: reads and writes
builder/services/cache/cache_service.go - Asset processing → Asset fingerprinting: fingerprints assets
README.md - Build engine → Search index manager: manages indexing
builder/orchestration/engine.go - Search index manager → Search index builder: generates index
builder/orchestration/search/manager.go - Content worker → Cache service: uses cached records
builder/services/content/worker.go - WASM search API → Search engine: runs queries
cmd/search/main.go - Site visitor → WASM search API: submits queries
README.md - Site visitor → Dev server: requests pages
README.md - Dev server → Build engine: builds and serves
internal/server/server.go - Dev server → File watcher: starts watching
internal/server/server.go - File watcher → Incremental manager: triggers rebuilds
internal/watch/watch.go - Incremental manager → Content service: rebuilds posts
builder/orchestration/incremental/manager.go - Incremental manager → Search index manager: refreshes search
builder/orchestration/incremental/manager.go