diff --git a/.impeccable.md b/.impeccable.md new file mode 100644 index 0000000000..a40ad3e71f --- /dev/null +++ b/.impeccable.md @@ -0,0 +1,81 @@ +# impeccable — project design notes + +Context and reusable UI patterns for design work in this app (Rails + Tailwind + +Stimulus + Turbo). Read this before building or reshaping UI so new work matches +the house patterns instead of reinventing them. + +## Design Context + +> Not yet captured. Audience, brand voice, and theme can't be inferred from the +> codebase — run `/impeccable teach` to fill this section in before doing +> open-ended design work. The pattern library below is safe to use regardless. + +## House UI patterns + +### Table view toggles (+ the sliders) + +When a table needs to reshape what it shows without leaving the page, we use two +complementary controls, both showcased together in the **events registrants +toolbar** (`app/views/events/_registrants_results.html.erb`) — the best example +to copy from. + +**1. Segmented display toggle** — swaps what the table shows on a reload: +*which rows* (a filter over the dataset) or *which layout variant* renders. +Server-driven: each segment is a `link_to` inside a pill `