Skip to content

clubpay/ronykit

RonyKIT

codecov FOSSA Status Go Report Card

RonyKIT is a Go toolkit for building high-performance API and edge servers. It gives you two entry points: a batteries-included framework (rony) and a low-level toolkit (kit) so you can pick the right level of control without rewriting your handlers.

Choose your entry point

  • rony: recommended, fast setup, opinionated defaults.
  • kit: low-level building blocks for custom gateways, clusters, or protocols.
  • stub: client stubs (work in progress).

Why RonyKIT

  • Define contracts once; serve REST and RPC from the same handlers.
  • Declarative service descriptors with strong typing via Go generics.
  • Pluggable gateways and clusters (fasthttp, gnet, redis, p2p).
  • Performance-oriented by design with minimal framework overhead.
  • Tooling for scaffolding and upgrades via ronyup.

Getting started

go install github.com/clubpay/ronykit/ronyup@latest
ronyup setup -d ./my-project -m github.com/you/myproject -p MyProject

Read the Getting Started Guide for the full walkthrough.

Architecture

Architect

Examples

Browse runnable examples in example.

Performance

Benchmarks can help estimate framework overhead relative to business logic. See the TechEmpower JSON benchmark for a reference point and compare against your own workloads.

Benchmark Results

Project layout

  • rony: batteries-included framework built on RonyKIT
  • kit: core building blocks and interfaces
  • std: standard gateway and cluster bundles
  • flow: workflow helpers
  • stub: stub generation utilities
  • ronyup: project setup and upgrade tool
  • example: runnable examples

Build commands

# Install required tools
make setup

# Run tests
make test

# Clean up the project
make cleanup

# Update version (patch)
make new-version-patch

# Update version (minor)
make new-version-minor