Polyrole-cs example: chat

sdzx-1 · August 16, 2026, 4:39am

README-EN.md

master

# A Multi-User Chat Room Built with Zig and polyrole-cs: Features, Implementation, and Code Analysis

## 1. Project Overview

This is a multi-user chat room example written in **Zig 0.16** and **polyrole-cs**. It is not just a minimal demo; it is a relatively complete protocol communication project that demonstrates how to run multiple protocols over a single TCP connection while implementing authentication, push, keepalive, kicking, and history persistence.

The source code is organized as follows:

```text
src/
├── protocol.zig     Shared data types, TUI context, codec types
├── control.zig      Control protocol: authentication + user commands + admin commands
├── push.zig         Push protocol: server-owned one-way event stream
├── keepalive.zig    Keepalive protocol: ping / pong
├── hub.zig          Accounts, sessions, broadcast, event queues, history persistence
├── mux.zig          Three-protocol Mux registration and result diagnostics
├── server.zig       TCP server entry point
├── client.zig       TUI / non-TTY client entry point
├── graph.zig        State graph generator
└── hub_test.zig     Automated tests

This file has been truncated. show original

sdzx-1 · August 16, 2026, 4:42am

Connect to the Live Server (Important)

A public test server is already deployed and ready to connect.

Address: 38.76.217.180

Port: 12345

Running build: Release / x86_64 / statically linked

./zig-out/bin/chat_client 38.76.217.180 12345