goadesign/goa
Goa
Goa is a design-first Go framework that generates server and client code, documentation, and request validation from a single declarative domain-specific language (DSL). At its core, it provides a Go DSL for defining API endpoints, data types, and error models, which compiles into fully functional HTTP and gRPC server stubs, client packages, and OpenAPI specifications.
The framework distinguishes itself through its plugin-extensible code generation pipeline, allowing custom code generation steps, middleware, or transport layers to be added via plugins. It supports multiple transport protocols from the same design definition, enabling HTTP, gRPC, and WebSocket communication without code duplication. Automatic request validation checks incoming payloads against the DSL-defined schema before they reach handler logic, ensuring data integrity without manual validation code.
Goa automatically generates and serves OpenAPI 2.0 and 3.0 documentation directly from the API design, keeping documentation synchronized with implementation. The framework produces ready-to-use client libraries from the same design definition used for server code, maintaining consistency across the entire API surface.
Features
- API-First Design Workflows - Defines API endpoints, data types, and error models in a declarative DSL that compiles into server and client code.
- API - Provides a Go DSL for defining service endpoints, data types, and error models that compiles into executable code and OpenAPI specs.
- API Code Generators - Produces fully functional HTTP and gRPC server stubs from the API design specification.
- Plugin-Extensible Code Generation Pipelines - Ships a plugin-extensible compilation pipeline that allows custom code generation steps, middleware, or transport layers.
- OpenAPI Specification Generators - Automatically generates and serves OpenAPI 2.0 and 3.0 specifications directly from the API design.
- Design-First Code Generators - Generates fully functional HTTP and gRPC server stubs and client packages from a single declarative Go DSL.
- Multi-Transport Code Generators - Produces fully functional HTTP and gRPC server stubs and client packages from a single API design file.
- Contract-First API Frameworks - A design-first Go framework that generates server and client code, documentation, and validation from a single declarative DSL.
- DSL-Driven Validations - Validates incoming requests automatically against the DSL-defined schema before reaching handler logic.
- Compilable DSLs - Provides a Go DSL that compiles into fully functional HTTP and gRPC server stubs and client packages.
- Request Validation - Automatically validates incoming request payloads against the DSL-defined schema before handler logic.
- Request Validation and Routing Pipelines - Checks incoming request payloads against DSL-defined schemas before they reach handler logic.
- DSL-Driven Generation - Generates server and client code by compiling a declarative domain-specific language into executable implementations.
- Client Library Generators - Generates ready-to-use client libraries from the same API design definition used for server code.
- Multi-Protocol Code Generators - Generates HTTP, gRPC, and WebSocket server stubs and client packages from a single design definition.
- Design Compilation Plugins - Extends the design compilation pipeline with custom code generation steps, middleware, or transport layers through a plugin system.
- API Transport Abstractions - Maps a single API design to HTTP, gRPC, and WebSocket transports through a unified code generation pipeline.
- Code Generation Pipeline Plugins - Extends code generation by inserting custom steps into the design compilation process via a plugin interface.
- Code Generation Plugins - Ships a plugin system for extending the design compilation pipeline with custom code generation steps and transport layers.
- Microservices - Microservice design framework.
- Service Governance and Platforms - Framework for design-first service development and API generation.
- API Design and Generation - Design-first framework that generates API code and documentation.
- Language Toolkits - Design-based HTTP microservices framework for Go.
- Web Frameworks - Design-first framework generating API code and documentation.
