Skip to content

Demos Overview

Felix includes a set of runnable demos that showcase core capabilities such as pub/sub, cache operations, latency benchmarking, and multi-tenant workflows. Each demo is a self-contained binary: it starts an in-process broker and QUIC server on a random local port, runs the scenario, and exits.

Quick notes

  • You do not need a separately running broker for these demos.
  • Demo auth helpers are enabled for convenience (not production-safe).
  • The RBAC live demo starts a control plane, broker, and fake IdP on local ports.
  • All commands are run from the repository root.
  • If you use Task, run task demo:pubsub, task demo:cache, task demo:latency, task demo:notifications, task demo:orders, task demo:rbac-live, or task demo:cross-tenant-isolation.

Demo catalog

Live RBAC Policy Change (demo-rbac-live)

  • Demonstrates live RBAC mutations via the control plane API and immediate authorization changes in the broker without restarts.
  • Uses a fake ES256 OIDC IdP and the real Felix token exchange flow.
  • Exercises publish/subscribe/cache operations before and after RBAC updates.
  • Uses an in-memory control-plane store (no Postgres required).
cargo run --manifest-path demos/rbac-live/Cargo.toml

Expected output includes step-by-step PASS/FAIL markers such as:

STEP 9 publish denied: PASS
STEP 12 RBAC policies added: PASS
STEP 15 publish allowed: PASS

Cross-Tenant Isolation (demo-cross-tenant-isolation)

  • Proves tenant boundaries are enforced end-to-end by the broker.
  • Uses a Postgres-backed control plane, a fake ES256 IdP, and real token exchange.
  • Demonstrates that a t1 token cannot access t2 resources.
cargo run --manifest-path demos/cross_tenant_isolation/Cargo.toml

Expected output includes step-by-step PASS/FAIL markers such as:

STEP 13 t1 publish allowed: PASS
STEP 16 t1 token on t2 publish denied: PASS
STEP 19 t2 token publish denied: PASS

Pub/Sub Demo (pubsub-demo-simple)

What it does: - Demonstrates a basic QUIC publish/subscribe round-trip - Shows subscription, publishing, and event delivery

Run: 

task demo:pubsub
# or
cargo run --release -p broker --bin pubsub-demo-simple

What to expect: - Step-by-step logs ending with two events (hello, world) and "Demo complete"

Cache Demo (cache-demo)

What it does: - Benchmarks cache put, get_hit, and get_miss over QUIC - Reports latency percentiles and throughput - Performs a TTL sanity check

Run: 

task demo:cache
# or
cargo run --release -p broker --bin cache-demo

Useful env vars: 

FELIX_CACHE_BENCH_WARMUP=200
FELIX_CACHE_BENCH_SAMPLES=2000
FELIX_CACHE_BENCH_PAYLOADS=0,64,256,1024,4096
FELIX_CACHE_BENCH_CONCURRENCY=1
FELIX_CACHE_BENCH_KEYS=1024
FELIX_CACHE_BENCH_OPS=put,get_hit,get_miss

What to expect: - A config summary line - Per-payload stats including p50/p99/p999 and throughput

Latency Demo (latency-demo)

What it does: - Measures pub/sub latency and throughput - Supports fanout, batch size, and payload tuning

Run: 

# Basic run
task demo:latency
# or
cargo run --release -p broker --bin latency-demo

# Custom configuration
cargo run --release -p broker --bin latency-demo -- \
    --binary \
    --fanout 10 \
    --batch 64 \
    --payload 4096 \
    --total 10000 \
    --warmup 500

What to expect: - One or more result lines with p50/p99/p999 latencies - Throughput metrics (overall and per-subscriber)

Notifications Demo (pubsub-demo-notifications)

What it does: - Simulates multi-tenant real-time alerts - Demonstrates tenant isolation and fanout - Writes "last N" alerts to cache - Supports subscriber drop/restart

Run: 

task demo:notifications
# or
cargo run --release -p broker --bin pubsub-demo-notifications

Optional flags: - --alerts=10 (default: 10) - --last-n=5 (default: 5) - --drop-subscriber

What to expect: - Cross-tenant access blocked - Subscriber fanout logs per tenant - Cache snapshot output for last_alerts

Orders/Payments Pipeline Demo (pubsub-demo-orders)

What it does: - Implements a three-stage pipeline: orders -> payments -> shipments - Uses idempotent workers and cache-backed state - Supports worker restart mid-run

Run: 

task demo:orders
# or
cargo run --release -p broker --bin pubsub-demo-orders

Optional flags: - --orders=12 (default: 12) - --duplicate-every=5 (default: 5) - --kill-worker=payments

What to expect: - Step-by-step pipeline logs - Cache snapshot output for each order - Final summary matching expected processed count