goadesign / examples

Examples for goa showing specific capabilities

Goa Examples

This repository contains examples of microservices implemented using Goa. Each example focuses on a specific topic as indicated by the directory name. The cellar example provides a complete implementation of a simple microservice.

The samples in each directory serve as templates, and you can clone them using the gonew command, as explained in this blog post.

$ go install golang.org/x/tools/cmd/gonew@latest
$ gonew goa.design/examples/basic@latest github.com/<your_repo>/basic
$ cd basic

A fully instrumented example of a system consisting of multiple Goa microservices is included in the Clue repo.

To get started with the Goa Clue example, you can use the gonew command to clone it into your own repository:

$ gonew github.com/goadesign/clue/example/weather github.com/<your_repo>/weather
$ cd weather

Please follow the README in the Clue repository for more details on running and testing the Goa Clue example.

As you study each example consider contributing back by providing better or more complete docs, adding clarifying comments to code or fixing any error you may run across!