Organizing Go code

Guidance on package boundaries, repositories, commands, and library/application layout in Go.

• Author: Andrew Gerrand
• Authority: primary
• Kind: blog
• URL: https://go.dev/blog/organizing-go-code

What it covers

• package boundaries
• cmd and library layout
• repository organization tradeoffs

Why authoritative

Go blog guidance on structuring packages and repositories.

Use when

• how should this Go repo be organized
• how should I split Go packages
• what is idiomatic Go package layout

Keywords

• package layout, project structure, commands, libraries, repo organization

Used by

• dependency-injection
• internal-packages
• package-layout