You will need bazel installed, preferably with bazelisk.

bazel run //server will build and launch the server on http://localhost:8080/hi

api contains the CUE specification for the API. It is exported from CUE into an OpenAPI YAML specification by the build. This is done with rules_cue.

The YAML specification is then transformed by oapi-codegen into a service handler in Go. This is done with rules_oapi_codegen.

The service is implemented in server/apiservice, with one file per resource. The generated code is not in the source tree, as usual with Bazel and as is familiar with all right-thinking software engineers. But you can read it in your local workspace under bazel-bin/server/apiservice/apiservice.go.

Future work:

• Implement a full resource-oriented API example.
• Implement an aip.dev compatible generator the CUE schema.
• Implement an aip.dev validator for the generated YAML.