oh-my-design-cli 1.0.2 → 1.2.0

package/{references → web/references}/resend/DESIGN.md

@@ -301,3 +301,76 @@ What makes Resend distinctive is its icy, blue-tinted border system. Instead of
 5. Multi-color accents at low opacity (12–42%) for backgrounds, full opacity for text
 6. Pill shape (9999px) for CTAs and badges, standard radius (4px–16px) for containers
 7. No shadows — use frost borders for depth against the void
+
+## 10. Voice & Tone
+
+Resend's voice is **dev-focused-elegant and API-first.** "Email for developers" — concise, capability-driven. Dark void canvas + frost-border depth signal "premium developer tool."
+
+| Context | Tone |
+|---|---|
+| CTA | Verb. "Get started", "Try it now", "Sign up" |
+| Marketing | API-first. Code snippets dominant in marketing |
+| Documentation | Code-first, framework-specific examples |
+| Error | Specific. "Invalid API key. Generate new one in Settings." |
+
+**Voice samples**
+- Tagline: *"Email for developers"* <!-- verified: resend.com homepage 2026-05 -->
+- Recurring promo: *"Announcing Resend Forward"* <!-- verified: resend.com homepage 2026-05 -->
+
+**Forbidden phrases.** "Revolutionary email API". Aggressive SendGrid-comparison framing.
+
+## 11. Brand Narrative
+
+Resend was incorporated **January 2023** (open-source `react.email` predecessor launched 2022) by **Bu Kinoshita** and **Zeno Rocha** ([Resend — How we got here](https://resend.com/handbook/company/how-we-got-here), [Y Combinator — Resend](https://www.ycombinator.com/companies/resend)). The pair launched **react.email** in 2022 because they were frustrated by how difficult it was to build modern email templates that worked across all email clients — that OSS distribution lever became the founder-edge for the commercial Resend product. They **immediately quit their jobs and moved to San Francisco** to join **Y Combinator's Winter 2023 (W23)** batch — **Launch HN: Resend (YC W23)** thread is publicly archived ([Hacker News — Launch HN: Resend](https://news.ycombinator.com/item?id=36309120)). After YC: **$3M seed round** ([Y Combinator/TechCrunch — Resend $3M](https://www.linkedin.com/posts/y-combinator_developer-focused-email-platform-resend-raises-activity-7087087056081866753-GaNB)). Modern email API positioned for developers — React Email components + clean DX. Strong YC + community adoption among indie SaaS builders. The brand voice tracks this positioning: minimal chrome, dark canvas, premium-developer aesthetic.
+
+## 12. Principles
+
+1. **Code is the marketing.** *UI implication:* hero shows real API code, never marketing illustration.
+2. **No shadows, frost borders.** *UI implication:* depth via translucent borders against dark void.
+3. **Pill (9999px) for CTAs and badges.** *UI implication:* primary actions pill-shaped.
+4. **Standard radius (4-16px) for containers.** *UI implication:* mixed radius is intentional.
+5. **React Email is the OSS hook.** *UI implication:* surfaces lead with React Email examples.
+
+## 13. Personas
+
+*Personas are fictional archetypes informed by Resend user segments (indie SaaS founders, transactional email engineers, dev-tooling buyers), not individual people.*
+
+**Sofia Russo, 30, Milan.** Indie SaaS founder shipping authentication emails. React Email + Resend for clean DX.
+
+**Marcus Chen, 38, San Francisco.** Senior engineer migrating from SendGrid. Cares about deliverability + simple API.
+
+**Priya Krishnan, 27, Bengaluru.** YC startup building B2B SaaS. Resend as the only email service their team uses.
+
+## 14. States
+
+| State | Treatment |
+|---|---|
+| **Empty (no domains)** | "Add your first domain" CTA + DNS setup |
+| **Empty (no API keys)** | "Generate first API key" CTA |
+| **Loading (sending)** | Per-email status visible |
+| **Loading (DNS verifying)** | Persistent badge with check button |
+| **Error (DNS not verified)** | Specific record + value to add |
+| **Error (rate limit)** | Tier limit + upgrade |
+| **Success (sent)** | Implicit; appears in dashboard |
+| **Success (domain verified)** | Subtle confirmation |
+| **Skeleton (email log)** | Frost-border placeholders |
+| **Disabled (no plan)** | Upgrade link |
+| **Loading (long batch)** | Persistent progress |
+
+## 15. Motion & Easing
+
+| Token | Value | Use |
+|---|---|---|
+| `motion-instant` | 0ms | Selection |
+| `motion-fast` | 150ms | Hover |
+| `motion-standard` | 250ms | Modal, panel |
+
+Standard cubic-bezier; no bounce — premium register. `prefers-reduced-motion: reduce` removes hover transitions.
+
+---
+
+**Verified:** 2026-05-08 (omd:migrate run 50 — Apple-tier)
+**Tier 1 sources:** resend.com home + /pricing (live DOM via playwright — **Primary `#00a3ff` Resend Blue 4px** / 41px / 12×20 / 14px·**600** + Tab pill `rgba(24,25,28,0.88)` Charcoal-translucent 16px (pricing tab active) + Announcement banner 9999px translucent blue (top promo) + Outline ghost 16px + Mid-Gray `#a1a4a5` nav text).
+**Tier 2 sources:** styles.refero.design / getdesign.md — no record.
+**Tier 2 (Philosophy/founders):** Resend handbook (How we got here), Y Combinator (Resend W23), Hacker News (Launch HN W23), LinkedIn (YC TechCrunch $3M post), No Cap Blog (Rocha), Mintlify customer story.
+**Style ref:** `stripe`. **Conflicts unresolved:** none. **Earlier mistake reverted (significant):** prior footer captured 16px tab/ghost variants only — canonical Primary is `#00a3ff` **Resend Blue 4px** (the brand-defining color, missed entirely). §4 material correction.

package/{references → web/references}/revolut/DESIGN.md

@@ -183,3 +183,77 @@ What distinguishes Revolut is its pill-everything button system. Every button us
 2. All buttons are pills (9999px) with generous padding
 3. Zero shadows — flat is the Revolut identity
 4. Near-black + white for marketing, semantic colors for product
+
+## 10. Voice & Tone
+
+Revolut's voice is **fintech-bold and segment-aware.** "Banking & Beyond" — confident, multi-segment positioning (Personal / Business / Kids & Teens). Pill chrome (9999px) signals "modern fintech" while flat-no-shadow design signals "no-nonsense banking."
+
+| Context | Tone |
+|---|---|
+| CTA | Verb. "Get started", "Try Revolut", "Sign up" |
+| Marketing | Segment-targeted. Personal vs Business vs Teens copy distinct |
+| Onboarding | KYC-aware. Plain-language compliance |
+| Error | Specific. "Insufficient funds. Top up via bank transfer." |
+
+**Voice samples**
+- Tagline: *"Banking & Beyond"* <!-- verified: revolut.com homepage 2026-05 -->
+- Segment nav: *"Personal / Business / Kids & Teens"* <!-- verified: revolut.com homepage -->
+
+**Forbidden phrases.** "Revolutionary fintech". Aggressive crypto-bro framing.
+
+## 11. Brand Narrative
+
+**Revolut Ltd was incorporated December 2013** by **Nikolay "Nik" Storonsky (CEO)** with **Vlad Yatsenko (CTO)** joining shortly after; the consumer product **launched 2015** at **Level39 fintech accelerator, Canary Wharf, London** ([Revolut — Wikipedia](https://en.wikipedia.org/wiki/Revolut), [Nik Storonsky — Wikipedia](https://en.wikipedia.org/wiki/Nik_Storonsky)). Storonsky was **the company's first investor (£300,000 of his own savings)**. **Yatsenko**: graduated with honors, worked at **Comarch (Krakow programmer)** → **UBS (London senior software developer 2010)** → brief stints at **Deutsche Bank + Credit Suisse** through 2014. Storonsky and Yatsenko are **both immigrants** ([The Vertical — immigrant founders Revolut](https://thevertical.la/development/who-are-the-immigrant-founders-behind-revolut-the-45-billion-neobank-eyeing-u-s-expansion/)). Originally a multi-currency travel card → expanded to full neobank with stocks, crypto, lending, insurance. **Valuation timeline**: $45B secondary share sale 2024 → **$75B November 2025** ([City AM — Revolut $75B](https://www.cityam.com/revolut-inside-nik-storonskys-75bn-fintech-empire-still-hunting-for-its-crown/)). **IPO timeline**: per Bloomberg April 20 2026 interview, Storonsky stated **~2 years from IPO with U.S. listing preferred**. The brand voice — bold, multi-segment, flat-design — tracks the product's evolution from single-card to financial super-app.
+
+## 12. Principles
+
+1. **Multi-segment first-class.** Personal / Business / Kids & Teens. *UI implication:* segment nav at top level.
+2. **Pill chrome 16px+.** *UI implication:* primary actions and nav use 16px pill.
+3. **Zero shadows.** *UI implication:* depth via background contrast, never shadow.
+4. **Near-black `#0e1318` + white marketing.** *UI implication:* marketing chrome stays achromatic.
+5. **Semantic colors only in product.** *UI implication:* charts + status use semantic; marketing stays neutral.
+
+## 13. Personas
+
+*Personas are fictional archetypes informed by Revolut user segments (multi-currency travelers, freelancers, EU SMB, Gen Z), not individual people.*
+
+**Catherine Liu, 32, London.** UK-based consultant traveling EU monthly. Multi-currency wallet + travel insurance.
+
+**Marcus Müller, 38, Berlin.** Freelancer with EUR/USD income streams. Revolut Business for invoicing.
+
+**Sofia Park, 18, Seoul.** Teens account holder traveling for university applications.
+
+## 14. States
+
+| State | Treatment |
+|---|---|
+| **Empty (no transactions)** | "Top up to start" CTA |
+| **Empty (no investments)** | "Browse stocks/crypto" link |
+| **Loading (price feed)** | Last cached + stale indicator |
+| **Loading (KYC)** | Persistent badge with progress |
+| **Error (KYC)** | Specific reason + remediation |
+| **Error (payment)** | Receipt-style failure + retry |
+| **Success (transaction)** | Receipt with full details + emoji-free confirmation |
+| **Success (deposit)** | Confirmation + when funds available |
+| **Skeleton (account list)** | Pill placeholders |
+| **Disabled (no funds)** | Top up inline link |
+| **Loading (long action)** | Multi-step progress |
+
+## 15. Motion & Easing
+
+| Token | Value | Use |
+|---|---|---|
+| `motion-instant` | 0ms | Toggle |
+| `motion-fast` | 150ms | Hover |
+| `motion-standard` | 250ms | Modal, panel |
+| `motion-pulse` | continuous | Live price update |
+
+Standard cubic-bezier; no bounce — fintech register. `prefers-reduced-motion: reduce` disables price pulse.
+
+---
+
+**Verified:** 2026-05-08 (omd:migrate run 51 — Apple-tier)
+**Tier 1 sources:** revolut.com/en-US home + /en-US/business (live DOM via playwright — **all-pill 9999px** chrome with canvas-aware Charcoal/Light pair: **Charcoal `#191c1f`** Primary (consumer light canvas) + **Light Surface `#f4f4f4`** Inverse (Business dark canvas + feature cards) + Translucent `rgba(244,244,244,0.10)` on-dark hover, all 9999px / 42px / 10×24 / 16px·**500**).
+**Tier 2 sources:** styles.refero.design / getdesign.md — no record.
+**Tier 2 (Philosophy/founders/valuation/IPO):** Wikipedia (Revolut + Nik Storonsky), Huxley (Yatsenko Ukrainian billionaire bio), The Vertical (immigrant founders narrative), City AM ($75B Nov 2025), MoneyWeek, Bloomberg Billionaires, FinTech Magazine.
+**Style ref:** `stripe`. **Conflicts unresolved:** none. **Earlier addition:** Charcoal `#191c1f` Primary + Light Surface `#f4f4f4` Inverse + canvas-aware pair + translucent variant missed by prior pass (which captured 38px segment-nav only — canonical is 42px Primary).