Skip to content

feat: add referral dashboard for verified users#21

Merged
OthmanImam merged 2 commits into
StelTade:mainfrom
Marvy247:feat/referral-dashboard
Mar 31, 2026
Merged

feat: add referral dashboard for verified users#21
OthmanImam merged 2 commits into
StelTade:mainfrom
Marvy247:feat/referral-dashboard

Conversation

@Marvy247
Copy link
Copy Markdown
Contributor

Summary

Implements the user referral dashboard as described in issue #13.

Changes

  • src/app/api/users/[id]/dashboard/route.ts — new API endpoint returning points, rank, referral code, referral list (anonymized), and verification status. Returns 403 for unverified users.
  • src/components/ReferralDashboard.tsx — dashboard UI component
  • src/app/dashboard/page.tsx — protected /dashboard route

Features

  • Referral link displayed with one-click copy to clipboard
  • Social share buttons: Twitter/X, Facebook, WhatsApp
  • Stats: points, leaderboard rank, total vs successful referrals
  • Referred users listed as Referral #N — no PII exposed
  • Verified/Pending badge per referred user
  • Access guard: redirects to homepage if no userId in localStorage
  • API returns 403 for unverified accounts
  • Fully responsive (mobile + desktop)
  • Loading skeleton and error states handled

Closes #13

- New src/components/Leaderboard.tsx displaying top 10 users by points
- Anonymizes user identities (User<last4ofId>) — no PII exposed
- Shows rank (medal for top 3), display name, points, and referral count
- Handles ties via API ordering (points DESC, created_at ASC)
- Auto-refreshes every hour via setInterval
- Loading skeleton, error alert, and empty-state handled
- Responsive layout works on mobile and desktop
- Integrated into homepage below Hero section

Closes StelTade#12
- New GET /api/users/[id]/dashboard — returns points, rank, referral
  code, total/successful referrals, and anonymized referral list
  (403 if user not verified)
- New src/components/ReferralDashboard.tsx — displays stats, referral
  link with copy-to-clipboard, social share buttons (Twitter, Facebook,
  WhatsApp), and anonymized referred-users list with verified status
- New /dashboard page — guards access via userId in localStorage,
  redirects unauthenticated users to homepage
- No PII exposed: referred users shown as 'Referral #N' only
- Fully responsive (mobile + desktop)

Closes StelTade#13
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented Mar 30, 2026

@Marvy247 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@OthmanImam OthmanImam merged commit fedaa78 into StelTade:main Mar 31, 2026
0 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Develop User Referral Dashboard

2 participants