Skip to main content

Design Philosophy

The guiding principles that make Pithos a modern utility library

This document defines the architectural choices and design philosophy of Pithos, drawing inspiration from best practices of modern libraries (es-toolkit, Remeda, Radash) while establishing its own identity.

Table of Contents​

  1. The Synergistic Ecosystem - Modules that amplify each other
  2. Error Handling - Fail fast, fail loud
  3. Immutability vs Mutability - Immutable by default
  4. TypeScript-First - Designed for inference
  5. Data-First vs Data-Last Paradigm - Data-first by default
  6. API Design - One function, one responsibility
  7. Performance & Bundle Size - Every byte counts
  8. Documentation & DX - TSDoc is not optional
  9. Comparison with Alternatives - Know the landscape

This documentation covers the how: the practical rules that implement our vision. For the foundational principles and decision-making philosophy behind these choices, see Core Philosophy.