goserve Docs

Appearance

goserveGo REST API Framework

A robust framework for building efficient, reliable and scalable server-side applications

PostgreSQL Example
MongoDB Example
Microservices Example
View Framework on GitHub
goserve mascot
🏗️

Feature Separation

Clean architecture with modular design for maintainable and scalable applications

⚡

High Performance

Built on Go, Gin, and optimized database drivers for blazing-fast REST APIs

🧪

Testability

Simplified unit and integration testing ensuring high-quality, production-ready code

🔐

Security First

JWT authentication, middleware support, and secure patterns built-in

🗄️

Database Support

PostgreSQL (pgx) with connection pooling and MongoDB integrations

⚡

Redis Integration

Built-in Redis support for caching

📦

Production Ready

Validator, Viper config, and crypto utilities included out of the box

🚀

Example Projects

Complete example implementations to get you started quickly

Technology Stack ​

goserve is built with industry-standard Go libraries:

  • Go 1.21+ - Modern, efficient programming language
  • Gin - Fast HTTP web framework
  • JWT (RS256) - Secure RSA-signed token-based authentication
  • pgx - PostgreSQL driver with connection pooling
  • MongoDB Driver - Official Go driver for MongoDB
  • go-redis - Redis client for caching and sessions
  • Validator - Request validation utilities
  • Viper - Configuration management
  • Crypto - Cryptographic utilities

Latest Version: v2.1.2

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

📚 Documentation ​

Getting Started ​

Example Projects ​

Learn by example with complete, production-ready implementations:

1. PostgreSQL Example ​

Complete REST API with PostgreSQL, Redis, JWT authentication, role-based authorization, and comprehensive testing.

2. MongoDB Example ​

Complete REST API with MongoDB, Redis, and JWT authentication.

3. Microservices (gomicro) ​

Microservices architecture with Kong API gateway, NATS messaging, and Docker orchestration.

Quick Start ​

Install goserve ​

bash
go get github.com/afteracademy/goserve

Try the PostgreSQL Example ​

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

bash
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.

Community & Resources ​

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!

Released under the Apache 2.0 License

Copyright © 2026 AfterAcademy