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.

Features

Protocol	Support
Connect (JSON/Proto)	Native
gRPC	Via Tonic integration
gRPC-Web	Via tonic-web layer

• 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

📖 Documentation

Development

Claude Code Skills

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

Skill	Description
submit-issue	Report bugs, request features, or ask questions
resolve-issue	Investigate and resolve GitHub issues
test	Run the full test suite

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:

cd connectrpc-axum-examples
cargo run --bin connect-unary

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.