Tutorials

Step-by-step guides to build different types of services with Goa.

Goa Core Tutorials

Explore Goa’s core features through these step-by-step tutorials, each focusing on a common API development scenario. By following along, you’ll gain hands-on experience with the Goa design-first approach, generated code, transport layers, error handling, streaming, and more.

Use these tutorials as a progressive guide to master Goa’s design-first philosophy. Whether you’re building RESTful services or advanced gRPC microservices, these examples provide a solid foundation for real-world projects.

In This Section

Basic REST API

Create a production-ready REST API with Goa using a concert management system example, covering API design, implementation, testing, and advanced encoding features.

Basic gRPC Service

Build a complete gRPC service using Goa’s design-first approach, covering service design, implementation, protobuf handling, and deployment of a concert management system.

Error Handling

Comprehensive guide to error handling in Goa, covering error definition, transport mapping, custom error types, and best practices for building reliable APIs.

Streaming

Learn to implement streaming endpoints in Goa for both HTTP and gRPC transports, covering server-side streaming, client-side streaming, and bidirectional streaming patterns.

Static Content

Learn to serve static files, integrate HTML templates, and host Single Page Applications (SPAs) in your Goa services using built-in file serving capabilities.