/go-chi-template

Starter template for building RESTful APIs in Go with Chi

Primary LanguageGoMIT LicenseMIT

go-chi-template

A simple and idiomatic REST API boilerplate in Go using Chi, designed for clarity, modularity and extensibility.
Includes Swagger documentation, basic validation and a clean separation of concerns.

✨ Features

  • 🧱 Modular project structure (cmd/, internal/)
  • 🔀 Routing and middleware with chi
  • 📄 Swagger UI documentation (/docs)
  • ✅ Request validation with go-playground/validator
  • 🧪 Unit-test friendly structure
  • 🐳 Minimal Docker support
  • 🧰 Designed as a reusable starter template

📦 Technologies

  • Go 1.22+
  • chi v5
  • logrus
  • swaggo/swag for Swagger
  • go-playground/validator

🚀 Getting Started

# Install swag if not already installed
go install github.com/swaggo/swag/cmd/swag@latest

# Generate Swagger docs
swag init -g cmd/server/main.go

# Run the server
go run ./cmd/server