Explanation

It's usually good to know the "why" behind the patterns and decisions we make.

These essays are lighter to read than reference docs, but they make you think, question, and understand. Don't just skim them - engage with the ideas, wrestle with the concepts, and come to your own conclusions.

If you get stuck or want to discuss something, we're here to help.

Design Philosophy

  • The Storyboard Approach - Stop thinking incrementally. Always send the complete current state. Why sending full HTML is more efficient than you think, and how it simplifies everything.
  • Explicit Input, Explicit Output - Go-style handlers with closures for dependencies. Why everything is visible in the function signature.

Patterns

  • CQRS Pattern - Separate reads from writes. Persistent SSE queries + stateless commands. Multiplayer for free.

Observability

  • Telemetry Design - Why Stario uses trace-based logging. Development visibility vs production JSON.