grpc-rest-app

gRPC REST-like App

Description

A basic address book app built using a gRPC API exposed via a REST-like endpoint using Envoy.

Prerequisites

• Node v18 or above
• Docker (if you have trouble running the envoy Docker image, you can install Envoy directly)

Running the demo

1. Install dependencies and build the apiTypes project.

npm install
npm run build:apiTypes

2. In a new window, run the API server.

npm run dev:api

3. In a new window, run the client web server.

npm run dev:client

4. In a new window, run the proxy server on Docker.

docker compose -f packages/proxy/docker-compose.yaml up

⚠️ If you get 500 errors when testing the client or API, you can install Envoy directly and run the configuration by executing envoy -c envoy.yaml.

5. You can test that the API is running properly by browsing to the following link:

http://localhost:8080/v1/contacts

6. Visit the address book front end app.

http://localhost:5173