design

This repository documents development principles and design patterns for building R packages in the tidyverse ecosystem. It serves as a guide for package developers who want to follow tidyverse conventions and best practices.

The principles are structured as actionable patterns, each explaining what the pattern is, why it matters, and providing concrete examples from existing tidyverse functions. Each principle includes both positive and negative examples, discusses exceptions, and offers specific guidance on how to apply or remediate the pattern. This complements the tidyverse style guide by focusing on higher-level design decisions rather than code formatting.