ConnectRPC Axum

A Rust library that brings ConnectRPC protocol support to the Axum web framework, with optional Tonic integration for serving gRPC or gRPC-Web on the same port.

Status: Under active development. Not recommended for production use yet.

📝 The Origin of connectrpc-axum - Learn about the problems this library solves and the design decisions behind it.

Features

Server

• Type-safe handlers generated from Protocol Buffers
• Full Axum ecosystem support (extractors, middleware, state)
• Automatic content negotiation (JSON/binary protobuf)
• All protocols served on the same port

Client

• Type-safe RPC client generated from Protocol Buffers
• All RPC patterns: unary, server streaming, client streaming, bidirectional
• JSON and protobuf encoding support
• Request compression (gzip, brotli, zstd)
• Middleware support via interceptors

📖 Documentation

Development

Claude Code Skills

This project includes Claude Code skills to assist with development. See the skill files in .claude/skills/ for details.

Architecture

See architecture.md for detailed documentation on the project structure, core modules, and design decisions.

Examples

See connectrpc-axum-examples for complete working examples.

Acknowledgments

This project started as a fork of AThilenius/axum-connect.

Learn More

• ConnectRPC Protocol
• Axum Documentation
• Tonic gRPC

License

MIT License - see LICENSE for details.