Go Project Structure

 1myproject/
 2├── cmd/                    # Main applications
 3│   └── myapp/
 4│       └── main.go
 5├── internal/               # Private application code
 6│   ├── app/
 7│   ├── pkg/
 8│   └── config/
 9├── pkg/                    # Public library code
10│   ├── api/
11│   └── utils/
12├── api/                    # API definitions (OpenAPI, Protocol Buffers)
13├── web/                    # Web assets
14├── configs/                # Configuration files
15├── scripts/                # Build and deployment scripts
16├── test/                   # Additional test data and helpers
17├── docs/                   # Documentation
18├── examples/               # Example code
19├── tools/                  # Supporting tools
20├── vendor/                 # Vendored dependencies (optional)
21├── go.mod                  # Module definition
22├── go.sum                  # Dependency checksums
23├── Makefile                # Build automation
24└── README.md

 1mycli/
 2├── cmd/
 3│   └── mycli/
 4│       └── main.go          # Entry point
 5├── internal/
 6│   ├── command/             # Command implementations
 7│   │   ├── init.go
 8│   │   ├── run.go
 9│   │   └── status.go
10│   └── config/
11│       └── config.go        # Configuration handling
12├── go.mod
13├── go.sum
14├── Makefile
15└── README.md

 1package main
 2
 3import (
 4    "fmt"
 5    "os"
 6    
 7    "github.com/user/mycli/internal/command"
 8)
 9
10func main() {
11    if err := command.Execute(); err != nil {
12        fmt.Fprintf(os.Stderr, "Error: %v\n", err)
13        os.Exit(1)
14    }
15}

 1myservice/
 2├── cmd/
 3│   └── server/
 4│       └── main.go
 5├── internal/
 6│   ├── handler/             # HTTP handlers
 7│   │   ├── user.go
 8│   │   └── auth.go
 9│   ├── service/             # Business logic
10│   │   └── user_service.go
11│   ├── repository/          # Data access
12│   │   └── user_repo.go
13│   └── model/               # Domain models
14│       └── user.go
15├── pkg/
16│   └── client/              # Public API client
17│       └── client.go
18├── api/
19│   └── openapi.yaml         # API specification
20├── configs/
21│   └── config.yaml
22├── go.mod
23└── README.md

 1package main
 2
 3import (
 4    "log"
 5    "net/http"
 6    
 7    "github.com/user/myservice/internal/handler"
 8    "github.com/user/myservice/internal/repository"
 9    "github.com/user/myservice/internal/service"
10)
11
12func main() {
13    // Initialize dependencies
14    repo := repository.NewUserRepository()
15    svc := service.NewUserService(repo)
16    h := handler.NewHandler(svc)
17    
18    // Setup routes
19    http.HandleFunc("/users", h.HandleUsers)
20    
21    // Start server
22    log.Println("Server starting on :8080")
23    log.Fatal(http.ListenAndServe(":8080", nil))
24}

 1mylib/
 2├── pkg/
 3│   └── mylib/
 4│       ├── core.go
 5│       ├── core_test.go
 6│       ├── utils.go
 7│       └── utils_test.go
 8├── examples/
 9│   ├── basic/
10│   │   └── main.go
11│   └── advanced/
12│       └── main.go
13├── docs/
14│   ├── getting-started.md
15│   └── api.md
16├── go.mod
17├── go.sum
18└── README.md

 1.PHONY: build test clean run
 2
 3# Build binary
 4build:
 5	go build -o bin/myapp cmd/myapp/main.go
 6
 7# Run tests
 8test:
 9	go test -v ./...
10
11# Run tests with coverage
12test-coverage:
13	go test -v -coverprofile=coverage.out ./...
14	go tool cover -html=coverage.out
15
16# Run linter
17lint:
18	golangci-lint run
19
20# Format code
21fmt:
22	go fmt ./...
23
24# Tidy dependencies
25tidy:
26	go mod tidy
27
28# Run application
29run:
30	go run cmd/myapp/main.go
31
32# Clean build artifacts
33clean:
34	rm -rf bin/
35	rm -f coverage.out
36
37# Install dependencies
38deps:
39	go mod download
40
41# Build for multiple platforms
42build-all:
43	GOOS=linux GOARCH=amd64 go build -o bin/myapp-linux-amd64 cmd/myapp/main.go
44	GOOS=darwin GOARCH=amd64 go build -o bin/myapp-darwin-amd64 cmd/myapp/main.go
45	GOOS=windows GOARCH=amd64 go build -o bin/myapp-windows-amd64.exe cmd/myapp/main.go