Skip to content

About

An infrastructure lab workspace exploring high-performance systems and decentralized primitives using Rust, Go, and TypeScript. Features prototype crates for kernel-bypass networking (AF_XDP), an observable core, and a localized JWT-auth runtime validation slice.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

NexxusFlow: Sovereign Foundations for High-Performance Systems

CI Pipeline License Version

NexxusFlow is a production-grade educational platform designed to teach the architecture, security, and observability of high-performance sovereign systems.

🚀 Hero Features

  • Production-Ready JWT Lab: HS256 signing, rate limiting, token revocation, and secret rotation.
  • High-Performance Data Plane: Rust-based AF_XDP packet handling prototypes.
  • Full-Stack Observability: Integrated Prometheus, Grafana, and OpenTelemetry tracing.
  • Educational First: Guided tutorials, interactive walkthroughs, and a visual UI.

🏗 Architecture

NexxusFlow follows a layered approach:

  • Data Plane (Rust): Low-latency, zero-copy networking components.
  • Control Plane (Go): Reliable management services (e.g., JWT Auth).
  • Contract Layer (TypeScript): Shared schemas ensuring runtime safety.
graph TD
    Client[Web Frontend / CLI] -->|Auth Request| JWT[JWT Auth Service - Go]
    JWT -->|Metrics| Prom[Prometheus]
    Prom --> Grafana[Grafana Dashboards]
    JWT -->|Logs/Traces| OTel[OpenTelemetry]
    DataPlane[AF_XDP Data Plane - Rust] -->|Packets| JWT
Loading

📚 Learning Paths

Start your journey in the `education/` folder:

  1. Getting Started: Bootstrap your environment in 5 minutes.
  2. JWT Fundamentals: Master production-grade authentication.
  3. Observability Deep Dive: Learn to monitor what matters.

🛠 Quick Start

make bootstrap
make education-demo
./scripts/interactive-walkthrough.sh

🧪 Validation

make test          # Run all workspace tests
make lint          # Run clippy, eslint, and go vet
make smoke-jwt-lab # Validate Docker Compose config

📜 License

This project is licensed under the AGPL-3.0 License. See LICENSE for details.

About

An infrastructure lab workspace exploring high-performance systems and decentralized primitives using Rust, Go, and TypeScript. Features prototype crates for kernel-bypass networking (AF_XDP), an observable core, and a localized JWT-auth runtime validation slice.

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages