How to Integrate gRPC with React and TypeScript

How to Integrate gRPC with React and TypeScript

As UI developers, we often rely on RESTful APIs or GraphQL to communicate with backend services. However, gRPC (gRPC Remote Procedure Calls) offers a high-performance, efficient, and strongly typed alternative that can significantly enhance the way our front-end applications interact with back-end services. In this blog, we'll explore how to integrate gRPC into a React application using TypeScript.

What is gRPC?

gRPC is a modern open-source Remote Procedure Call (RPC) framework initially developed by Google. It uses HTTP/2 for transport, Protocol Buffers as the interface description language, and provides features such as authentication, load balancing, and more.

Why Use gRPC in UI Development?

  • Efficiency: gRPC uses HTTP/2, enabling multiplexed streams and reduced latency.

  • Strong Typing: With Protocol Buffers (protobuf), you get a strongly typed schema, reducing the chances of runtime errors.

  • Streaming: gRPC supports client, server, and bidirectional streaming, which can be beneficial for real-time updates.

  • Cross-language: gRPC supports multiple languages, making it easier to work with diverse backend environments.

Understanding Protocol Buffers

What are Protocol Buffers?

Protocol Buffers, or protobuf, is a language-neutral, platform-neutral extensible mechanism for serializing structured data. Think of it as a simpler, faster, and more efficient alternative to XML or JSON.

Defining Protobuf Messages and Services

Create a .proto file to define your gRPC service and messages. Here’s an example:

syntax = "proto3";

package example;

service Greeter {
  rpc sayHello (HelloRequest) returns (HelloReply) {}

message HelloRequest {
  string name = 1;

message HelloReply {
  string message = 1;
  • Service Definition (Greeter): Defines a service named Greeter with an RPC method SayHello that takes a HelloRequest message and returns a HelloReply message.

  • Message Definitions (HelloRequest and HelloReply): Define the structure of the request and response messages.

    When you compile this .proto file using grpc-tools, it generates the necessary client and server code. In this case, the generated code includes GreeterClient and HelloRequest.

  • GreeterClient: This is the client class that allows you to interact with the Greeter service. It contains methods corresponding to the RPCs defined in the .proto file (e.g., sayHello).

  • HelloRequest: This is a class that represents the request message for the SayHello RPC. You use it to construct the request that you send to the server.

  • string name = 1

    • string indicates the type of the field. In this case, the type is a string (a sequence of characters).

    • name is the name of the field. It is a human-readable identifier used to access this field in the code.

    • = 1 assigns a unique number to this field within the message. This number is used internally to identify the field in the serialized binary format.

Setting Up the Environment


Before we dive in, ensure you have the following installed:

  • Node.js and npm/yarn

  • Basic knowledge of React and TypeScript

Installing Required Packages

We’ll need a few packages to get started:

npm install @grpc/grpc-js @grpc/proto-loader grpc-web grpc-web-client

Setting Up gRPC-Web

Since browsers don't support HTTP/2 directly, we need to use gRPC-Web, a JavaScript client library that lets you call gRPC services from a browser.

 npm install grpc-web

Implementing gRPC in a React Application

Creating a React Project

Create a new React project with TypeScript using Create React App:

npx create-react-app grpc-react-app --template typescript
cd grpc-react-app

Integrating gRPC Client

Set up the gRPC client in your React application. Here’s how to do it:

  1. Generate client code from your .proto file as shown earlier.

  2. Create a React component to use the gRPC client.

Here’s an example:

import React, { useState, useEffect } from 'react';
import { GreeterClient } from './proto/greeter_grpc_web_pb';
import { HelloRequest } from './proto/greeter_pb';

const client = new GreeterClient('http://localhost:8080');

const App: React.FC = () => {
  const [message, setMessage] = useState<string>('');

  useEffect(() => {
    const request = new HelloRequest();

     // Call the sayHello method on the GreeterClient
    client.sayHello(request, {}, (err, response) => {
      if (err) {
         console.error('Error:', err.message);
         // Retry logic or user notification
      } else {
         // Get the message from the response and update the state
  }, []);

  return (
      <h1>Integrating gRPC with React and TypeScript</h1>

export default App;
  • Creating the Client:const client = new GreeterClient('http://localhost:8080') creates an instance of the GreeterClient that connects to the gRPC server running at http://localhost:8080. you can replace this http with your deployment URL.

  • Creating the Request:const request = new HelloRequest(); creates a new HelloRequest message.

  • Setting Request Fields:request.setName('World'); sets the name field of the HelloRequest message.

  • Making the RPC Call:client.sayHello(request, {}, (err, response) => { ... }); makes the sayHello RPC calls using the GreeterClient. The callback function handles the response or error.

Debugging gRPC Calls

Using gRPC-Web Developer Tools

Leverage developer tools and browser extensions for debugging gRPC-Web calls:

  • gRPC-Web Developer Tools: Available as a Chrome extension, it allows you to inspect gRPC-Web requests and responses directly in your browser.


gRPC offers numerous advantages for UI developers, including efficiency, strong typing, and support for streaming. By following the steps outlined in this blog, you can integrate gRPC into your React and TypeScript applications, leveraging its full potential for building robust and high-performance user interfaces.

Further Reading and Resources:-