Introducing AgentUI: Typed React Components for LLM Agents
AgentUI hit 1.0 today. It's a typed event protocol and React component registry that lets LLM agents drive UI without touching the DOM.
Read articleIdeas & engineering
Articles
Personal writing on the decisions, systems and practical details behind useful software. Original publication dates and version context are preserved.
One-Way vs Two-Way Doors in Software Development
A practical mental model for engineering teams: when to move fast on reversible decisions and when to slow down for ones you can't easily undo.
Read articleShipping AgentUI v1: The Library Upgrade
An engineering retrospective on taking AgentUI from a working 0.3 prototype to a v1.0-ready OSS package — the rewrite, the subagent pipeline, the lessons.
Read articleBuilding VoxGate AI — Part 1: How I Built It
Architecture of an LLM agent inside a multi-tenant CRM: streaming UI protocol, tool calling, panel-mode collaboration, and what actually worked.
Original publication context included
Read articleBuilding VoxGate AI — Part 2: What I Learned Building It
Engineering challenges, failed approaches, panel-mode coordination, prompt drift, and a build-vs-buy verdict from shipping an LLM agent inside a CRM.
Original publication context included
Read articleSystem Design — From URL Shortener to Distributed Cache
A hands-on walkthrough of system design fundamentals — starting with a URL shortener and scaling up to a distributed cache, covering the patterns that repeat across every design interview.
Read articleEvaluating LLM Agents — Metrics, Benchmarks, and CI Integration
How to build an evaluation framework for LLM agents — from defining metrics and creating test cases to running automated evals in CI and catching regressions before production.
Original publication context included
Read articleBuilding a RAG Pipeline from Scratch with TypeScript
A step-by-step guide to building a Retrieval-Augmented Generation pipeline in TypeScript — from document chunking and embeddings to vector search and context-aware generation.
Read articleStructured Output from LLMs — Parsing, Validation, and Recovery
How to reliably extract typed, validated data from LLM responses — using Zod schemas, retry strategies, and provider-native structured output modes.
Read articleDependency Injection in TypeScript Without a Framework
How to implement clean dependency injection in TypeScript using only interfaces, factory functions, and a simple container — no decorators, no reflect-metadata, no magic.
Read articleBuilding Type-Safe Event Systems with TypeScript Generics
How to build a fully type-safe event emitter in TypeScript where event names, payloads, and handlers are all validated at compile time — no more string typos or wrong payloads.
Read articleBranded Types and Phantom Types in TypeScript
How to use branded and phantom types in TypeScript to make invalid states unrepresentable — turning runtime bugs into compile-time errors with zero overhead.
Read articleBuilding a Type-Safe API Layer with Server Actions and Zod
How to build a fully type-safe API layer in Next.js using Server Actions, Zod validation, and a thin wrapper that eliminates boilerplate while keeping runtime safety.
Read articleAuthentication Patterns in Next.js App Router
A practical guide to implementing authentication in Next.js App Router — middleware guards, server-side sessions, protected API routes, and the patterns that actually work in production.
Read articleServer Components vs. Client Components — A Decision Framework
A practical decision framework for choosing between Server and Client Components in Next.js App Router — with real examples, performance tradeoffs, and common mistakes.
Read articleBehavioral Design Patterns — From Concept to TypeScript
Master the 11 behavioral design patterns with real-world analogies, TypeScript implementations, and clear guidance on when to choose each one.
Read articleCreational Design Patterns — From Concept to TypeScript
Master the 5 creational design patterns with real-world analogies, TypeScript implementations, and guidance on when to use each one.
Read articleDesign Patterns: The Complete Map Before the Journey
A visual catalog of all 23 Gang of Four design patterns — named, categorized, and explained in one sentence each. Start here before diving deep.
Read articleStructural Design Patterns — From Concept to TypeScript
Master the 7 structural design patterns with real-world analogies, TypeScript implementations, and clear guidance on when to choose each one.
Read articleAgent-Customizable Web Apps: Let Users Reshape Your App With AI
How to build a core web app that users can personalize by running AI code agents inside it — architecture, sandboxing, use cases, and a practical implementation guide.
Original publication context included
Read articleBuilding a Website Summarizer with FastAPI, Next.js, and the Vercel AI SDK
A step-by-step guide to building a website summarizer that scrapes pages, summarizes them with LLMs, and lets users switch between models on the fly using the Vercel AI SDK.
Read articleBuilding LLM Agents with Custom UI Components
How I built AgentUI — an open-source protocol that lets LLM agents compose, update, and remove UI components through structured events instead of raw HTML.
Read article