What it does
codemap generates a one-page interactive map of a Go module. Run a single go run command in your module's folder with Go 1.24 or later, and it writes one HTML file showing every package, what each package builds on within the module, and the functions in each of its files. Open it in a browser to search, click a package to see what it uses and what uses it, and, for a module hosted on GitHub, jump to any function's line. The layout puts foundations at the bottom and commands at the top, wider boxes have more functions, and colours mark top-level folders. Tests, vendor and testdata are left out. The author checked its counts against cobra, gin, hugo, prometheus and kubernetes; Kubernetes, with 1,278 packages and 34,823 functions, takes under two seconds and produces a 4.5 MB page. Because the output is a single file with nothing to serve, it can go on any website, and a GitHub Action can build it in CI. A sister project does the same for Perl. MIT licensed.
Who it’s for
Go developers joining or maintaining a large codebase.
Use cases
- Getting oriented in a large Go codebase on your first day
- Publishing a browsable architecture map alongside project docs
- Spotting unexpected dependencies between packages in code review

