ReferralCandy Brand Guide Refresh

Started work

Phase 1: Brand direction explorations Created 3 initial directions in rc-brand-directions.html: - D1 Vibrant Confidence (Plus Jakarta Sans, bold pink+blue, geometric illustrations) - D2 Refined Pop (Fraunces serif + DM Sans, editorial, minimal line art) - D3 Electric Gradient (Sora, pink-to-blue gradient as brand element, tech-forward) Feedback from Zach: directions look good but feel cold. Wants warmth, trust, and authenticity to come through visually. Adding warmer directions now.

Added 2 warm directions based on feedback D4 Warm Trust: Bricolage Grotesque display + Nunito body. Warm palette with honey (#FFB74D), cocoa (#2D2226), toffee (#8B7355) supporting the pink/blue primaries. People-first illustrations with faces, storefronts, organic curved connections. Pill-shaped buttons, generous border-radius. Voice: genuine, supportive, honest, celebratory. D5 Human Connection: Lexend display + Source Serif 4 body (serif for warmth/depth). Introduced teal (#14B8A6) as third color representing the relationship between advocate and friend. Ripple/conversation illustrations with faces and speech bubbles. Voice: empathetic, story-driven, calm confidence, personal. Overview tab now shows all 5 directions categorized as tech-forward (1-3) vs warmth-focused (4-5). Key design contrast: - D4 is warmer in PALETTE (honey, cocoa, warm white) — feels like a cafe - D5 is warmer in TYPOGRAPHY (serif body) and METAPHOR (ripples, stories) — feels like a letter from a friend

Expert brand review complete — analysis/expert-review.md Key recommendations: - Build from D2's bones (Fraunces + DM Sans, restrained voice, minimal illustration) - Add D4's candy naming system (Honey, Cocoa, Toffee) + warm backgrounds - Use D5's teal-as-connection color + ripple as signature visual motif - Voice: D2's confidence + D3's occasional punch + humor (currently missing from all) - Biggest gap: no central brand concept, no photography direction, candy metaphor unexplored - Why D4/D5 feel generic: Nunito is 'friendly font default', rounded-everything is category hygiene not brand-specific, warmth expressed as emotion words not visual specificity - Key color insight: need muted/warm variant of pink that works beyond screens, plus a signature neutral (not Tailwind greys) - Illustration: ripple as ownable motif, candy-as-visual-properties (glossy, rounded, dimensional), mix handmade + digital

Wild directions v2 complete — rc-brand-directions-v2.html D6 Sweet Science: Candy metaphor fully embraced. Glossier-meets-candy-shop. Frosted glass effects, candy-wrapper diagonal stripe textures, Outfit font (bubbly but professional). Coral (#FF6B6B), peach (#FFDAB9), vanilla (#FFF8E7) alongside pink. Illustrations use actual candy shapes — wrapped candies as network nodes, candy jar filling for rewards, lollipop bars for growth. Voice uses candy metaphors sparingly. D7 Neighbourhood: Anti-SaaS. Shantell Sans (hand-drawn display), Caveat (handwritten annotations), DM Sans (body). Dashed borders, warm mustard (#E5A100), sage (#8FAE7E), terracotta (#D4845A). Sketchy illustrations with stick figures, wobbly arrows, Caveat annotations baked into SVGs. Voice is conversational and opinionated ('Look, here's the thing...'). D8 Signal: Radical constraint. Monochromatic pink — 7 stops from #FFF0F5 to #4D042D. Blue ONLY for data viz. Outfit 900 weight, uppercase UI labels, sharp 4px corners. Bold flat single-color illustrations. Voice is extremely concise: 'Referrals. Automated.'

Expert review v2 complete — D6-D8 critique Updated synthesis across all 8 directions: - D2 bones (Fraunces + DM Sans, editorial restraint) - D7 voice (conversational, opinionated, has actual humor) - D7 annotation mechanic (Caveat handwritten notes as brand element) - D6 candy warmth (color palette vocabulary, candy as source material) - D8 constraint thinking (monochromatic pink scale, tinted neutrals) - D5 ripple motif + teal connection color Key new insight: D7's voice is the strongest across ALL 8 directions — beats D2's previous lead. The conversational 'here's the thing' quality is exactly the warm-but-with-edge the founder wants. Refined direction HTML being built now with all gaps addressed.

Refined brand guide complete — rc-brand-refined.html (2600 lines) Comprehensive 9-tab brand guide synthesizing all 8 directions: - Brand concept: 'The best marketing is a friend saying try this' - Typography: Fraunces (italic as signature) + DM Sans + Source Serif 4 - Colors: Pink/blue/teal triad, candy-named neutrals (Cream, Meringue, Blush, Honey, Toffee, Cocoa), signature ink neutral (#2A2328), muted print variants - Candy pattern: Subtle SVG at 3-5% opacity — wrapped candies, round sweets, dot clusters. Multiple densities + corner accent variant. Also as illustration accents. - 5 illustrations with ripple motif + faces + candy accent shapes - Photography direction (candid, warm color treatment, do/don't) - Voice with 8 context examples + candy metaphor sweet spots vs sugar crash - Motion: ripple animations, candy confetti on success, timing specs - Brand architecture: referral (pink-led) vs affiliate (blue-led) - Light warm background throughout — not dark mode Addresses all gaps from expert review. Ready for founder review.

Founder review of rc-brand-refined.html — key feedback: 1. LOGO: Keep current logo unchanged. Remove any logo redesign from the guide. 2. FRAUNCES ITALIC: Hard to read — need to reconsider display font or reduce italic usage 3. CANDY PATTERN: Concept approved but too subtle — can't see it. Needs more visibility. 4. ILLUSTRATIONS: 'Seems amateur' — biggest gap. Needs sophisticated, systematic approach like Farscry. Wants a well-defined pattern that can reliably generate professional on-brand graphics. 5. PHOTOGRAPHY: Currently just icons/filler. Needs actual guidance on how to use photographs. 6. MOTION: Wants working animated demos, not just principles. Next: Fix all of the above + get 3-perspective review (brand expert, UX designer, merchant)

Triple review complete — analysis/triple-review.md Brand Strategist (7.2 avg): Strong tagline and voice. Candy naming excellent. Illustrations look AI-generated not professional. Fraunces italic needs restriction. Missing long-form voice examples. UX Designer (5.8 avg — lowest): Critical WCAG AA failures on pink/blue/teal against light backgrounds. Three-font load ~315KB too heavy for embedded app. No Polaris compatibility documented. No focus states. Merchant Grace (7.2 avg): Voice speaks her language. Candy element clever because subtle. Illustrations feel like wireframes. Critical gap: no co-branding guidance (how RC brand coexists with merchant brand on referral pages/emails). Priority fixes: 1. Fix color accessibility (darker text variants needed) 2. Professional illustration quality (concepts right, execution prototype-level) 3. Polaris compatibility mode 4. Co-branding guidance for customer-facing surfaces

Shared to doc-shared — all brand guide files pushed to GitHub Files at https://github.com/Anafore/doc-shared/tree/main/brand-guide/: - index.html (refined v2 — comprehensive 9-tab brand guide) - directions-v1.html (D1-D5) - directions-v2.html (D6-D8) - expert-review.md, expert-review-v2.md, triple-review.md GitHub Pages: https://anafore.github.io/doc-shared/brand-guide/

Completed SaaS branding research — analysis/brand-research.md Researched: branding principles from 6+ sources, analyzed 10+ SaaS brands (Mailchimp, Klaviyo, Gorgias, Yotpo, Smile.io, Notion, Slack, ClickUp, Gusto, etc.), studied illustration systems, rebrand case studies. Key strategic findings: 1. EVERY referral/loyalty competitor uses blue or purple — pink is completely uncontested 2. Best SMB SaaS brands balance warmth + credibility (Mailchimp, Gorgias, Gusto) 3. Ownable illustration systems (ClickUp hidden logo, Notion characters) are the biggest differentiator 4. Typography must be distinctive — Inter/Jakarta Sans = invisible, custom fonts = memorable 5. Voice needs a point of view — forgettable brands say safe things, memorable ones are opinionated 6. The candy metaphor is an asset no competitor can copy Derived 8 design principles from research, not from guessing.

v3 brand guide complete and shared — research-grounded fresh build Built from scratch using 8 research-derived principles. Key decisions: - Brand concept at product-agnostic level (trust/authenticity/human connection) - 3 concept options proposed: 'Growth starts with trust', 'People-powered growth', 'Brands grow when people share what they love' - Pink-first color strategy (own it like Mailchimp owns yellow) - Bricolage Grotesque display font (distinctive, warm, not default SaaS) - 3 signature illustration options: The Ripple, The Candy Wrapper, The Connection Line - Voice: smart friend who runs a store, with actual humor - Competitive positioning chart vs Yotpo/Smile.io/Friendbuy/Mention Me Shared to: https://anafore.github.io/doc-shared/brand-guide/v3.html Research: https://anafore.github.io/doc-shared/brand-guide/brand-research.md

DECISION: Brand concept locked — 'Genuine relationships grow brands' Arrived at through iterative discussion: - A/B/C rejected (too product-specific, didn't stretch to affiliate/moments/loyalty) - D rejected ('honour the trust' felt extractive, trust-as-asset framing) - E1 selected — 'Genuine relationships grow brands' Why this works: - Sits above any single product (referral, affiliate, moments, loyalty all fit) - Relationship comes first, growth is the natural outcome (not extractive) - 'Grow' has organic double meaning (revenue + nurture) - Founder had visceral positive reaction ('got the shivers') - Grace test: resonates with merchants who care about genuine customer relationships

DECISION: Color system locked — pink + warm neutrals Pink (#FF0E8B) is THE brand color. No secondary brand color. Blue (#286FFA) downgraded from brand color to functional UI utility — for data viz and multi-series charts only, not brand identity. System: - Brand: #FF0E8B (hot pink) - Dark neutral: #2A2328 (warm-tinted from pink) — text, dark UI - Light neutral: #FAF8F5 (warm off-white) — backgrounds - Links: pink or dark+underline, no separate color - Data/charts: pink opacity scale + quiet functional color for multi-series - Print variant: ~#E8447F (CMYK-safe) - Semantic: standard green/amber/red Key reasoning: - Blue was competing with pink (both saturated, similar visual weight) - Site drifted to purple because designers were subconsciously solving the pink+blue clash - Warmth comes from neutrals and brand experience, not from adding warm colors - 'Own one color' strategy (like Mailchimp=yellow, Shopify=green) - Externally (website, social, email, merch) = pink + warm neutrals only

DECISION: Typography locked (tentative) Display: Bricolage Grotesque — optical sizing, warm character, distinctive Body: DM Sans — clean, warm, stays out of the way Editorial (blog/docs): Source Serif 4 — if needed for long-form Founder is not 100% committed — wants flexibility to swap. Font change is a CSS variable swap, so low-risk to proceed with Bricolage and revisit later. One-font vs two-font: not yet decided. Playground available for continued testing.

Illustration discussion concluded — building visual spec Key decisions: - Character-driven system (no competitor has one) - Quality through restraint — fewer elements, more care, intentional negative space - Consistency through simplicity — characters defined by strict rules (circle head, dot eyes, simple body) so anyone/any LLM can reproduce - Genuine through specificity — illustrations show real RC user moments, not generic 'person uses laptop' - Pink always present in every illustration - Max 2-3 colors per illustration - Slight hand-drawn quality for human warmth - Building: character sheet (exact proportions) + scene library (compositions) + rules

Final brand guide complete and shared Deliverable: rc-brand-final.html (2308 lines) Shared: https://anafore.github.io/doc-shared/brand-guide/final.html Consolidates all locked decisions: - Concept: 'Genuine relationships grow brands' - Color: Pink-first (#FF0E8B), no secondary brand color, candy-named warm neutrals - Typography: Bricolage Grotesque + DM Sans + Source Serif 4 - Voice: 8 context examples with genuine humor, per-product flexes - Illustration: framed as brief for professional illustrator (rules + 8 scene descriptions) - Photography: shooting brief for real merchant photography - Candy layer: naming, pattern, occasional copy, celebration moments - Motion: 4 working demos (button hover, card hover, ripple click, confetti) - Brand architecture: 4 products with color assignments, logo rules, co-branding Next steps: - Founder review of final guide - Engage professional illustrator for reference character set + key scenes - Marketing team review and refinement - Font decision may revisit (Bricolage tentative)

IDEA: Cast of character friends + ecommerce object library Illustration concept from founder: - A CAST of named/recognizable characters representing different roles: advocate, affiliate creator, friend, audience member, loyal customer, new customer - A LIBRARY of ecommerce product objects: t-shirts, shampoo, supplements, gadgets, toys, sports equipment — all rendered in the same style - TWO MODES of use: 1. Casual/decorative: characters just hanging out (hero images, backgrounds, alongside text) 2. Scene/narrative: characters interacting to depict specific moments (referral, reward, sharing) This is powerful because: - Characters become recognizable over time (like Notion's cast) - Objects ground the brand in ecommerce reality (not abstract SaaS) - Combinatorial: any character + any object + any pose = new illustration - Scalable: new characters or objects can be added without redesigning the system - LLM-friendly: defined components can be composed programmatically Challenge: designing the initial character set and object library with enough personality to be memorable and enough simplicity to be reproducible. This reframes the illustration task from 'design scenes' to 'design a cast + props library' — much more like animation/game asset design than traditional illustration.

Character cast complete — character-cast.html 6 named characters designed with distinct silhouettes: - Maya (Advocate) — phone in hand, wavy hair, pink accent - Sam (Friend) — tilted head, textured crop, teal accent - Jordan (Creator) — headphones, locs-in-bun, tallest, amber accent - Priya (Loyal Customer) — shopping bag, long straight hair, rounder/shorter, rose accent - Alex (Merchant) — rolled sleeves, side-parted hair, slate blue accent - River (New Customer) — wide eyes, curly halo hair, slimmest, sage accent Plus 15 ecommerce object SVGs and 3 composition scenes. Shared: https://anafore.github.io/doc-shared/brand-guide/character-cast.html

DECISION: Illustration style direction locked Style synthesis: Headspace simplicity + Slack expressiveness + Kurzgesagt mood Key principles: - Characters built from ORGANIC BLOB SHAPES, not assembled body parts - Simpler than v2 — fewer lines, more shape-driven - Faces: minimal (dots + curve) but body shape itself conveys emotion - Color creates mood — warm washes, atmospheric, not just flat fills - Organic/wobbly shapes, not geometric - Complexity level: ~3-4/10 (Headspace=2, Slack=6, current v2=7) Rejected: Duolingo (too mascot/cartoon), Casper (wrong vibe) Liked: Headspace (emotion), Slack/Alice Lee (expressiveness, organic shapes, Mary Blair influence), Kurzgesagt (mood through composition)

Character cast v5 complete — final polish pass Three fixes applied: 1. Flush dots on Excited expression (all 6 characters) — categorical differentiator vs Happy 2. Character-edge glow in all scenes (18 radial gradients) — atmospheric depth 3. Standardized object interaction with connection shadows — consistent approach Score progression: v1 (3.5) → v2 (5.4) → v3 (7.5) → v4 (8.3) → v5 (targeting ~8.8-9) Shared: https://anafore.github.io/doc-shared/brand-guide/character-cast-v5.html

SESSION HANDOFF — Comprehensive state for next session pickup === WHAT THIS PROJECT IS === ReferralCandy brand guide refresh. Creating a modern, comprehensive brand identity from scratch — concept, colors, typography, illustration, voice, photography, motion, brand architecture. === LOCKED DECISIONS (do not revisit) === 1. Brand concept: 'Genuine relationships grow brands' - Sits above any single product (covers referral, affiliate, moments, loyalty) - Relationship comes first, growth is the natural outcome - Arrived at through iterative discussion eliminating 4 alternatives 2. Color system: Pink-first, no secondary brand color - Primary: #FF0E8B (hot pink) — OWN IT like Mailchimp owns yellow - Blue (#286FFA) downgraded to functional utility (data viz only), NOT brand identity - Warm neutrals with candy names: Cocoa #2A2328, Toffee #6B5E64, Honey #B8ADB2, Biscuit #E8E2E5, Cream #FAF8F5, Meringue #FFFAF8 - Print variant: #E8447F - No teal, no third brand color 3. Typography: Bricolage Grotesque (single font system) - ONE font for everything — display, body, UI - Optical sizing gives visual range within one family - Tentative — founder 'not 100%' but agreed to proceed (easy to swap) - Typography playground exists for future testing 4. Logo: keep current ReferralCandy logo unchanged 5. Illustration style direction: Headspace simplicity + Slack expressiveness + Kurzgesagt mood - Characters = organic blob shapes, NO outlines on bodies - Faces = dot eyes with white highlights + curved mouth only - Hair/hat = primary differentiator between characters - Arms always present, body ~42% head proportion - Max 3 colors per illustration, pink always present - Background washes at 8-12% opacity for atmosphere - Internal shading (darker ellipse per body blob) 6. Expression system: 5 expressions using 3 distinct eye TYPES - Happy: round dot eyes + smile - Excited: ^_^ curved arcs (not dots) + flush dots on cheeks - Neutral: dot eyes + flat mouth - Surprised: wider dots + O mouth - Grateful: downward curved eyes + gentle smile - NOTE: Happy vs Excited was flagged 4 times as too similar. The ^_^ fix was approved as 'much better' but founder noted in v5 review they still look similar. May need further refinement. 7. Character cast: 6 named characters - Maya (Advocate) — pink body, wavy hair, phone, bouncy shape - Sam (Friend) — teal body, backwards cap, tilted curious pose - Jordan (Creator) — gold/mustard #C4943A body, tallest, topknot + headphones - Priya (Loyal Customer) — rose body, long hair, roundest/widest, bag - Alex (Merchant) — slate blue body, beanie + round glasses + apron - River (New Customer) — sage green body, curly/afro hair, slimmest, wide eyes, lighter stroke color (#6B5E64) for facial features on dark skin === WHERE WE STOPPED === Character illustration aesthetic needs to be MORE DISTINCTIVE. Current blob style is 'good but generic.' Founder wants an unmistakable aesthetic — not a signature element (rejected candy pin/pink accent approaches) but a signature RENDERING STYLE. NEXT STEP: Image generation tournament using Recraft API (MCP server configured but not yet connected): - Round 1: Generate 8 character sets in different aesthetics - Round 2: Review panel scores → improve → cut to top 4 - Round 3: Develop top 4 → review → cut to top 2 - Round 4: Polish top 2 → select winner Recraft MCP server added to .mcp.json with API key. Needs Claude Code restart to connect. Images save to projects/rc-brand-guide/generated/ === SCORE PROGRESSION === Character illustrations: v1 (3.5) → v2 (5.4) → v3 (7.5) → v4 (8.3) → v5 (~8.8) The jump from v2→v3 was the blob/no-outline pivot. Most improvement came from style changes, not detail additions. === KEY FILES === Project dir: projects/rc-brand-guide/ - overview.md — project overview - drafts/rc-brand-final.html — CURRENT brand guide (10 sections, pink hero cover) - drafts/character-cast-v5.html — latest character cast (blob style, polished) - drafts/character-test.html — expression fix + brand signature tests - drafts/character-scenes.html — expanded scenes + backgrounds - drafts/type-playground.html — interactive typography explorer - drafts/character-cast-v4.html, v3.html, v2.html, v1 — prior iterations - drafts/rc-brand-v3.html, rc-brand-refined-v2.html, etc. — earlier brand guide versions - analysis/brand-research.md — SaaS branding research (principles + competitive) - analysis/illustration-research.md — illustration system research - analysis/character-review-v4.md — latest character review (8.3/10) - analysis/character-review-v3.md, v2, v1 — prior reviews Shared (doc-shared): https://github.com/Anafore/doc-shared/tree/main/brand-guide/ All key files pushed to doc-shared for viewing. === OPEN QUESTIONS === 1. What aesthetic makes the characters unmistakably ReferralCandy? (tournament will answer) 2. Font — Bricolage Grotesque is tentative, may revisit 3. Candy pattern — concept approved but visibility needs work 4. Co-branding — how RC brand coexists with merchant brands (not addressed yet) 5. Polaris compatibility — not addressed yet

Round 1 complete — 8 aesthetics, 16 images generated via Recraft MCP. Review page: drafts/aesthetic-tournament-r1.html. Top 2: Modern Folk (8.0) and Emotional Flat (8.0). Wildcards: Infantile Sketch (6.6) and Children's Book (6.2). Cut: Nostalgic Pastel, Pastel Sketch, Roundish Vector, Grainy Textured (keeping grain texture as technique steal). Next: Round 2 with 4 refined directions.

SESSION HANDOFF — Brand guide illustration tournament complete. Winner: F3 RC Wave (e613f72b). Brand guide updated: color triad (pink+dark+cream), illustration direction rewritten as professional illustrator brief, hero section cleaned up. Shared to doc-shared. Next: get designer feedback on the brand guide, then continue refining illustration style based on their input.

Drafting brief for Albert + Rachel on brand guide next steps

Brief drafted: projects/rc-brand-guide/brand-guide-brief.md — covers locked decisions, Albert's scope (color+typography), Rachel's scope (illustration direction), context on where we are

Brief sent to Albert + Rachel via Slack. Albert: color + typography. Rachel: illustration design direction (fresh start, goals-based). Target: lock all three at next product forum (Apr 1). Brief at https://github.com/Anafore/doc-shared/blob/main/brand-guide/brief.md

Reviewing Albert's proposals.html against final.html

Merged proposals 1-7 into final-v2.html. Excluded proposal 8 (font alternatives). Changes: pink depth, interaction states, product-line colors, neutral numbering, warm semantics, responsive type scale, letter-spacing rule.

Brand guide v2 pushed. Illustration directions scored against brief goals — Concept C strongest. Product forum tomorrow to discuss.

Product Forum 2026-04-01: Rachel presented Magic Pink Cloud concept + trend landscape. Team aligned on 80% whimsical for marketing. Zach flagged flexibility concern (what if cloud isn't there?). Pink locked. Cocoa needs warmth. Albert expanding palette. Rachel's deliverable: mood boards + illustration style guide. Half-tone/dot-matrix style personally appealing to all three.

From 2026-03-26 Selling Better sync: Albert completed first pass on typography (grotesque font family) and color system (single pink with depth scale, semantic tokens). Rachel handling illustration guidelines. Target: finalish version by next week before Rachel leaves April 10. Raúl to review brand personality section — use MKB to pull demo call positioning patterns. Candidate tagline: 'Genuine relationships grow brands.'

Craft pass session (2026-04-16): produced index-craft.html alongside v0.2 index.html in brand-guide repo. Full /impeccable craft + /critique + action-plan. Brand triad now structural (cocoa rail + pink cover + cream body), distinct admonition variants prove pink tonal range, visible WIP treatment, new Pink in Practice demo. Detector 14→6 issues (rest design-intentional). Pending: fix pink-soft contrast + /polish pass + decide if craft replaces baseline. Session log: sessions/2026-04-16-1238-brand-guide-craft-pass.md