Introduction

Welcome to the Pixelflux handbook. This book gathers everything about the project in one place: how to run it, how it is built, how it is tested and secured, and how it deploys. Every page is generated from the canonical Markdown in the repository, so it never drifts from the source.

📊 Prefer the short version? The project slides — a Marp deck on the architecture and SDLC — are authored as Markdown and published right beside this book.

What it is

A shared 200×200 pixel canvas: pick a colour, click to paint, and everyone sees the pixels appear live. The canvas lives in Redis (so it’s shared across instances) and updates are pushed over Server-Sent Events. With no Redis it falls back to an in-memory canvas, so it runs with zero dependencies.

The app itself is small — the point of the project is the tooling around it: a one-command dev shell, a tiny distroless container (< 20 MB, 0-CVE target), automated tests and security scans, and a Kubernetes deployment.