stephenh/ts-proto

Health v2 · maintenance only

Adoption not part of the score

2590 stars · 391 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

ts-proto is a protoc plugin that generates idiomatic, strongly-typed TypeScript code from protobuf schema files, including encode/decode methods and service types. It supports gRPC, Twirp, and NestJS integrations and uses @bufbuild/protobuf for low-level wire serialization in its 2.x releases.

Use cases

• generate TypeScript types from .proto files
• serialize and deserialize protobuf messages in TypeScript
• create typed gRPC clients and servers in TypeScript
• use protobuf schemas with NestJS
• prevent N+1 queries with auto-batching via dataloader
• integrate protobuf with Buf build tooling
• work with Twirp services in TypeScript

When to choose

• you want idiomatic TypeScript interfaces instead of protobufjs classes
• your stack is TypeScript/Node with gRPC, Twirp, or NestJS
• you use Buf and want a well-supported protobuf-to-TS plugin
• you need strongly-typed encode/decode and JSON conversion for proto messages

When to avoid

• you need runtime reflection or dynamic message handling rather than generated code
• you cannot adopt @bufbuild/protobuf and must stay on protobufjs primitives (use ts-proto 1.x)
• you are not using TypeScript or a protobuf-based workflow
• you prefer official first-party tooling like @bufbuild/protoc-gen-es

Facets

library · maturity active

serialization developer-tools developer-tools apis web-development backend cross-platform protobuf grpc twirp nestjs dataloader grpc-web buf schema-codegen code-generation nodejs typescript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="stephenh/ts-proto")