AB
Alysson Barrera
Contact

06 / Technical Writing

Technical Writing & Architecture

Explorations and architectural notes clarifying software trade-offs, state lifecycles, and maintainable module boundaries for engineering teams.

Technical article overviews

Frontend Architecture & ValidationVerified Overview

Multi-Schema Form Architecture with React Hook Form and Zod

How to structure complex multi-step and conditional forms using discriminated Zod unions, isolating form state while preserving full type inference across step boundaries.

Core Architectural Insights:
  • Discriminated unions ensure runtime validation matches step conditions
  • Type inference eliminates manual form interface duplication
  • Decoupling form layout from validation schema improves reusability
Code Organization & MaintainabilityVerified Overview

Module-Based Frontend Organization for Scaling Codebases

Moving beyond generic /components directories toward feature-owned module boundaries that encapsulate state, UI, API contracts, and tests in predictable structures.

Core Architectural Insights:
  • Feature-scoped folders reduce cross-file navigation friction
  • Public API exports (`index.ts`) help preserve module boundaries
  • Simplifies refactoring and isolated component testing using Storybook and Vitest