feat(referral): redesign the invite friends settings page

[tsahimatsliah]

Changes

Redesigns /settings/invite into a compact, flat page with one section rhythm, adds a giveback cross-promo, and replaces the copy-link button with a split copy/share control.

• Reward promo (flag-gated, default off) — Invite 3 friends, get 1 month of Plus with a compact tracker: three rounded-rect slots that fill with the referred developers' avatars, ending in a 1 month of Plus chip. Once the goal is met the tracker becomes a flat Plus-tinted card naming the reward and the month it covers. Progress comes from referredUsersCount on the generic referral campaign and is clamped to the goal inside the component. Behind referral_plus_reward; with it off the section reads "Grow the community" and promises nothing.
• Your invitation link — the link field now carries a split control: the left half copies the link and cross-fades the glyph to a checkmark, the chevron opens the standard share list (X, WhatsApp, Facebook, Reddit, LinkedIn, Telegram, Email, native share). Below laptop width it collapses to one button that opens the native share sheet. This replaces the old "or invite via" row, which held the same eight buttons a few pixels below the field.
• More ways to give back — GivebackInviteCard, wearing the same treatment as the giveback founding-reward card (1px gradient frame over an opaque base washed with the same gradient at 8% via color-mix). Gated on the existing giveback flag.
• Your referrals — unchanged list, now aligned with the rest of the page.
• Notifications (placeholder) — two new types, referral_friend_joined and referral_plus_unlocked, both deep-linking to /settings/invite. Marked as placeholders in code: no backend emits either one yet, so they are not complete and nothing produces them in production — they exist for the client to render and for Storybook to demo.
• Storybook: Features/Referral/Invite friends page covers 0/1/2/3+ referrals, unlocked, existing-Plus member, reward flag off, giveback off, mobile width, the share menu open, and the two notification rows.

Caution

Nothing grants the free month yet, so the reward is behind referral_plus_reward (default off). No backend gives a Plus month on the third referral, and the dates shown are derived on the client from the third referral's join date rather than entitlement data. With the flag off — the default, and what ships on merge — the page reads "Grow the community" and promises nothing. Flip the flag on only once fulfillment / authoritative entitlement data lands, and revisit the client-derived dates then.

Notes for reviewers

• ShareActions, SplitShareButton and CopyStateIcon are ported verbatim from the sharing-visibility branch (claude/share-split-copy-button), which ships them with its own PR and its own surfaces. Only the split variant is used here; the icon/inline variants come along so the two copies stay identical and the files dedupe cleanly whichever lands first. The two local additions are shortenUrl (the referral URL carries its own attribution, so it must go out unshortened) and a stopPropagation on each half of the split control — the text field's container focuses its input on click, which dismissed the menu the instant it opened.
• InviteLinkInput takes an optional actionButton that replaces its built-in copy button. Gated on the new prop, so the other five consumers keep their exact DOM and their existing copy handling. logProps is now optional for the same reason: it only drives the built-in button.
• UserList hard-codes px-6 on its rows and on its loading placeholder, and overrides the consumer's userInfoProps.className. Alignment is therefore handled with -mx-6 on a wrapper around the whole list, so rows, skeletons, and the empty state all line up with the headings.
• Deleted the single-export components/referral/index.ts barrel per the repo's no-barrel rule; the only other consumer (settings/organization) now imports the source file directly.
• GivebackInviteCard sizes its own charm rather than reusing GivebackMascot: that component bakes h-44 tablet:h-56 into the same class string a caller would override, and class names are concatenated rather than merged, so the hero size always wins. The charm render ships on solid black, so it is cut out with an SVG luminance-to-alpha filter — mix-blend-screen only works on a dark surface and made it vanish in light mode.

Events

No new event names. Existing events fire from new places:

Type	event_name	value
Change	copy referral link	now fired by the split control's copy half, target_id: invite friends page
Change	invite referral	now fired by the share menu, target_id is the provider
Change	click giveback gift entry	now also fired from the invite page giveback card with target_id: invite friends page

Experiment

referral_plus_reward — new flag, default false. A kill-switch for unfulfillable copy rather than an experiment: it gates the entire reward promise (title, Plus-member note, and tracker) so nothing ships to users until the backend grants the free month. Not enrolled as an experiment; if it should run as one, that enrolment needs approving before the flag is turned on. The existing giveback flag still gates the cross-promo section separately.

Manual Testing

Caution

Please make sure existing components are not breaking/affected by this PR

The page is auth-gated and the local webapp shell does not boot without a backend, so review it on the Vercel preview at /settings/invite, and the states in Storybook (pnpm --filter storybook dev) — the Storybook deployment is Ignored for PRs.

Verified locally: webapp suite (45 suites / 305 tests), shared suites for referral/share/fields/notifications (13 suites / 80 tests), pnpm --filter shared lint and pnpm --filter webapp lint clean, and the changed-file strict typecheck guard. The split control was checked in light and dark, on desktop and at mobile width, with the menu open and closed.

🤖 Generated with Claude Code

Preview domain

https://claude-refer-friend-settings-red.preview.app.daily.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
daily-webapp	Error		Jul 29, 2026 12:35pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
storybook	Ignored		Jul 29, 2026 12:35pm

[tsahimatsliah]

🧭 Task context (auto-maintained by /fresh)

• Goal: Redesign /settings/invite around an "invite 3 friends, get 1 month of Plus" promo, cross-promote the giveback campaign, and keep the page compact, flat, and visually consistent.
• Branch: claude/refer-friend-settings-redesign-a23ebe → main
• Updated: 2026-07-23

Current focus: PR is engineering-ready and pushed. Awaiting review; no known open work.

Decisions (and why):

• Plus reward gated behind new referral_plus_reward flag, default false — nothing in the product actually grants the free month yet, so shipping the promise unconditionally was a trust/support liability. Flag-off copy reads "Grow the community" and promises nothing.
• Flat/compact over a marketing-style hero — the first attempt (aurora glows, gradient headline, mascot card, how-it-works grid) was rejected as busy. Everything is a standard AccountContentSection with one card treatment and one accent.
• The tracker escalates: a quiet one-line row while the goal is open, a flat Plus-tinted card once it's met (no border — the tint carries it, matching the rest of the page). Unlocking previously only recoloured a chip border, which didn't read as an achievement. The card is deliberately compact: Body-bold headline, 32px reward tile, p-3, and a one-size-down (24px) avatar row in the footer.
• The free month's period is derived on the client from the join date of the INVITE_GOALth referral (sorted copy — the query specifies no order), because no backend field carries the grant. rewardPeriod is an optional prop so the page can swap in a real field without touching the component.
• Two notification types added frontend-side (referral_friend_joined, referral_plus_unlocked) with a new DevPlus icon type; both land in the Updates filter category. No backend emits them yet.
• The giveback charm's black background is cut out with an SVG filter (alpha derived from the artwork's own brightness, ramped so mid-dark art stays opaque), not mix-blend-screen and not a dark plate. Screen blending only worked over dark surfaces, and a dark tile was rejected as an unnecessary box. Cloudinary can't strip it at source (the URL is signature-locked; e_make_transparent 404s).
• The giveback card reuses the GivebackFoundingAward treatment (1px gradient frame + 8% color-mix wash) so the two read as one family. It is the page's single accent moment.
• Progress slots use rounded-10 to match ProfilePicture's radius — filled avatars and empty slots must share a silhouette.
• No em dashes in this feature's user-facing copy or Storybook story names (explicit user request). Code comments are untouched; the numeric date range keeps its en dash (2 Jul 2026 – 2 Aug 2026) — flagged to the user, not yet challenged.
• Components live in conventional homes: InviteRewardProgress in components/referral/, GivebackInviteCard in features/giveback/. Deleted the single-export components/referral/index.ts barrel per the no-barrel rule; settings/organization import updated as a consequence.

Key files:

• packages/webapp/pages/settings/invite.tsx — the page: 4 sections (reward promo, invitation link, giveback, referrals); derives rewardPeriod
• packages/shared/src/components/referral/InviteRewardProgress.tsx — locked row + flat unlocked card; InviteSlots has an isCompact variant; clamps joinedCount to INVITE_GOAL internally
• packages/shared/src/features/giveback/components/GivebackInviteCard.tsx — gradient cross-promo card + the charm cutout filter
• packages/shared/src/components/notifications/utils.ts — the two referral notification types + NotificationIconType.DevPlus
• packages/shared/src/lib/featureManagement.ts — featureReferralPlusReward (default false)
• packages/webapp/__tests__/AccountInvitePage.tsx — 9 tests (flag on/off, 0/2/3/12 counts, reward period, avatars, giveback href + click logging)
• packages/storybook/stories/features/referral/ — "Features/Referral/Invite friends page", 12 stories (incl. Notifications)
• packages/storybook/stories/components/notifications/_mock.tsx — referral rows also feed "Components/Notifications/Full page"

Done:

• Page redesigned, flattened, and iterated per feedback (compact progress, Plus named in the chip, rounded-rect slots, caption above the row, "Your invitation link" heading, how-it-works removed)
• Referrals list left-aligned with the rest of the page
• Giveback charm fixed for light mode via the SVG cutout filter
• Dominant → then compacted → then flattened unlocked reward card, with start/end dates
• Referral notifications designed and shown on the notifications page mock
• Em dashes stripped from feature copy and story names
• Storybook page covering every state
• Independent review pass; all findings fixed (flag gate, count-agnostic copy, loading-state alignment, 320px clipping, dead code, a11y, tests)
• Verified: webapp suite 45/45 (306 tests), shared notifications/referral/giveback suites green, eslint clean, changed-file strict typecheck clean, shared tsc errors all in the unrelated pre-existing useUserExperienceForm.spec.tsx

Next:

• Await review on feat(referral): redesign the invite friends settings page #6367
• Before enabling referral_plus_reward: backend must actually grant the free month on the third referral and emit the two notification types (and expose the real grant period), then revisit the unlocked copy

Gotchas:

• UserList hard-codes px-6 on its rows and on its loading placeholder, and overrides the consumer's userInfoProps.className. Align it with -mx-6 on a wrapper around the whole <UserList>; passing it via scrollingProps.className only reaches the loaded branch and leaves skeletons misaligned.
• GivebackMascot bakes h-44 tablet:h-56 into the same class string a caller would override, and class names are concatenated (not tailwind-merged), so smaller numeric overrides silently lose. The invite card sizes its own charm for that reason.
• The giveback charm artwork ships on solid black. GivebackMascot's dark-only consumers hide the same light-mode bug the invite card had; the cutout filter in GivebackInviteCard is the fix to lift if they ever land on a light surface.
• Adding a NotificationIconType requires updating three full Records in notifications/utils.ts (icon, icon theme, icon style) — TS enforces it.
• The Storybook Vercel deployment is Ignored for PRs — no hosted link. Review locally: pnpm --filter storybook exec storybook dev -p 6013.
• packages/storybook has no eslint binary installed, so pnpm --filter storybook lint fails on main too.
• /settings/invite is auth-gated, so visual review happens on the Vercel preview, not locally.
• .claude/launch.json is intentionally untracked (machine-specific port).
• __tests__/MyFeedPage.tsx "should request user feed" is flaky under the full suite; it passes in isolation. Re-run, don't debug.

To continue this task in a fresh chat: check out claude/refer-friend-settings-redesign-a23ebe, then run /fresh https://github.com/dailydotdev/apps/pull/6367.

[capJavert]

Blocking as documented in the PR: this unflagged page promises and displays a free Plus month, but no backend grants it and the displayed reward period is inferred from referral timestamps rather than entitlement data. Please either land fulfillment/authoritative entitlement data first or remove/flag the reward promise. The new notification types should not be treated as complete until the backend can emit them.

[tsahimatsliah]

@capJavert thanks, addressed in 73071ab.

• Reward is gated again. The whole promise — title, Plus-member note, and the tracker — is back behind referral_plus_reward, default false. With it off (the default, and what merges) the section reads "Grow the community" and promises nothing; the "Invite 3 friends, get 1 month of Plus" copy and the client-derived dates never render. Flip it on only once fulfillment / authoritative entitlement data lands, and the inferred reward period should be revisited then. Storybook has a "Reward flag off (default)" story and a webapp test asserting the promise is absent when the flag is off.
• Notifications marked as placeholders in code. Added a comment on ReferralFriendJoined / ReferralPlusUnlocked in notifications/utils.ts stating no backend emits them yet, so they're not complete — they exist only for the client to render and Storybook to demo. Happy to pull them out entirely into the backend PR instead if you'd prefer they not live here at all.
• PR description Experiment + caution sections updated to match.

Fulfillment / entitlement data is backend work outside this repo, so it can't land in this PR — the flag keeps the promise dark until it does.

[capJavert]

The reward promise is correctly gated behind referral_plus_reward with a false default, and the placeholder notification types are now explicitly documented. I found no remaining code blocker. Approved; sync with main before merge.