-
Notifications
You must be signed in to change notification settings - Fork 0
Home
MeGaNeKo edited this page Mar 20, 2026
·
2 revisions
Neoma is a modern REST API framework for Go that generates OpenAPI specs from your types, validates requests automatically, and supports pluggable error models. It is built with clean architecture and strict separation between type definitions and registration logic.
- Getting Started — Installation, hello world, running your first API
- Configuration — DefaultConfig, all config fields, schema options
- Operations — Registering endpoints, input/output structs, validation tags
- Error Handling — Pluggable error models, RFC 9457, convenience functions
- OpenAPI Specification — OAS generation, served endpoints, schema customization
- Public and Internal Specs — Dual spec support, hidden fields and operations
- Adapters — Chi, Echo, Gin, Fiber, stdlib; writing your own adapter
- Middleware — API, group, and operation middleware; Builder interface
- Auto-Discovery — neoma-discover tool for automatic error documentation
- Server-Sent Events — SSE package, registering streaming endpoints
- CLI Integration — neomacli, Cobra integration, flags, environment variables
- Testing — neomatest package, TestAPI, request helpers
- Migration from Huma — Import changes, API differences, migration checklist
- Huma Issues — Which Huma issues Neoma addresses