goserveGo API Backend Framework

📚 Documentation ​

Getting Started ​

• Installation - Install goserve and set up your project
• Getting Started - Quick start guide with examples
• PostgreSQL Example - Complete REST API implementation

Framework Guide ​

• Architecture - Framework architecture and design patterns
• Core Concepts - Controllers, services, DTOs, and patterns
• Configuration - Environment setup and configuration options

What is goserve? ​

goserve is a robust Go backend architecture framework that offers a performant and scalable foundation for building REST APIs. It emphasizes:

• Feature Separation: Clean, modular architecture that scales as your application grows
• Clean Code: Well-organized structure following best practices
• Testability: Simplified unit and integration testing patterns
• Production Ready: Built-in utilities for validation, configuration, and security

Technology Stack ​

goserve is built with industry-standard Go libraries:

• Go - Modern, efficient programming language
• Gin - Fast HTTP web framework
• JWT - Secure token-based authentication
• pgx - PostgreSQL driver with connection pooling
• go-redis - Redis client for caching and sessions
• Validator - Request validation utilities
• Crypto - Cryptographic utilities

Example Projects ​

Learn by example with complete, production-ready implementations:

1. goserve-example-api-server-postgres - Complete REST API with PostgreSQL, Redis, and JWT authentication
2. goserve-example-api-server-mongo - Complete REST API with MongoDB, Redis, and JWT authentication
3. gomicro - Microservices architecture with Kong API gateway, NATS messaging, and Docker orchestration

Quick Start ​

Install goserve ​

go get github.com/afteracademy/goserve

Try the PostgreSQL Example ​

The best way to get started is with the complete example project:

git clone https://github.com/afteracademy/goserve-example-api-server-postgres.git
cd goserve-example-api-server-postgres
go run .tools/rsa/keygen.go && go run .tools/copy/envs.go
docker compose up --build -d
curl http://localhost:8080/health

See the PostgreSQL Example Documentation for detailed setup and usage.

Learn More ​

Ready to dive deeper? Check out our comprehensive documentation:

• Framework Architecture - Understand goserve's layered design
• Core Concepts - Master controllers, services, and DTOs
• Configuration Guide - Set up your development environment

Why Choose goserve? ​

• ✅ Batteries Included: Everything you need for production REST APIs
• ✅ Clean Architecture: Feature-based organization that scales
• ✅ Easy Testing: Simplified patterns for unit and integration tests
• ✅ Active Development: Regularly updated with latest Go best practices
• ✅ Well Documented: Comprehensive examples and documentation
• ✅ Open Source: Apache 2.0 licensed, free to use

Community & Resources ​

• 🌟 GitHub Repository - Star us on GitHub (151+ stars)
• 📺 YouTube Channel - AfterAcademy tutorials and guides
• 📖 Article - Architecture deep dive
• 💬 Discussions - Ask questions and share ideas
• 🐛 Issues - Report bugs and request features

License ​

goserve is released under the Apache 2.0 License. See the LICENSE file for details.

Contributing ​

Contributions are welcome! Please feel free to fork the repository and open a pull request. See the Contributing Guide for more details.

Find this project useful? ⭐ Star it on GitHub to show your support!