code/yieldomega
Watch
4
0
Fork
You've already forked yieldomega
 0
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity

Frontend UX: update referrals, third-party venues, and 404 surfaces #296

New issue
Closed
opened 2026-06-06 09:35:13 +00:00 by PlasticDigits · 3 comments
PlasticDigits commented 2026-06-06 09:35:13 +00:00 (Migrated from gitlab.com)

Summary

Update secondary product routes (referrals, third-party venues, 404) to match the new cyberminimalist platform UX and ensure all TimeArena/referral/venue explanations are current.

Scope

  • Referrals dashboard: register, leaderboard, earnings panels
  • Third-party venue pages (Kumbaya, SIR)
  • 404 and under-construction fallback patterns
  • Stale cross-sell copy that references old mechanics

Key files

  • frontend/src/pages/ReferralsPage.tsx
  • frontend/src/pages/referrals/ReferralRegisterSection.tsx
  • frontend/src/pages/referrals/ReferralLeaderboardSection.tsx
  • frontend/src/pages/referrals/ReferralProgramEarningsSection.tsx
  • frontend/src/components/ThirdPartyDexPage.tsx
  • frontend/src/pages/NotFoundPage.tsx
  • frontend/src/pages/UnderConstruction.tsx

Constraints

  • Audit referral copy against docs/product/referrals.md (flat 5 CRED per side, not legacy BPS)
  • Do not assume existing page layout/content is up to date with TimeArena system
  • Secondary routes should feel like the same product, not leftover arcade pages

Acceptance criteria

  • Referrals, venue, and 404 surfaces match the new visual system
  • Referral explanations reflect current flat CRED mechanics
  • No stale TimeCurve/sale/PvE cross-sell copy remains
  • E2E specs (referrals-surface.spec.ts, navigation.spec.ts, footer-site-links.spec.ts) updated and passing
## Summary Update secondary product routes (referrals, third-party venues, 404) to match the new cyberminimalist platform UX and ensure all TimeArena/referral/venue explanations are current. ## Scope - Referrals dashboard: register, leaderboard, earnings panels - Third-party venue pages (Kumbaya, SIR) - 404 and under-construction fallback patterns - Stale cross-sell copy that references old mechanics ## Key files - `frontend/src/pages/ReferralsPage.tsx` - `frontend/src/pages/referrals/ReferralRegisterSection.tsx` - `frontend/src/pages/referrals/ReferralLeaderboardSection.tsx` - `frontend/src/pages/referrals/ReferralProgramEarningsSection.tsx` - `frontend/src/components/ThirdPartyDexPage.tsx` - `frontend/src/pages/NotFoundPage.tsx` - `frontend/src/pages/UnderConstruction.tsx` ## Constraints - Audit referral copy against `docs/product/referrals.md` (flat 5 CRED per side, not legacy BPS) - Do not assume existing page layout/content is up to date with TimeArena system - Secondary routes should feel like the same product, not leftover arcade pages ## Acceptance criteria - [ ] Referrals, venue, and 404 surfaces match the new visual system - [ ] Referral explanations reflect current flat CRED mechanics - [ ] No stale TimeCurve/sale/PvE cross-sell copy remains - [ ] E2E specs (`referrals-surface.spec.ts`, `navigation.spec.ts`, `footer-site-links.spec.ts`) updated and passing
PlasticDigits commented 2026-06-07 07:57:59 +00:00 (Migrated from gitlab.com)

mentioned in merge request !436

mentioned in merge request !436
PlasticDigits commented 2026-06-07 08:08:13 +00:00 (Migrated from gitlab.com)

Implemented #296 in MR !436: https://gitlab.com/PlasticDigits/yieldomega/-/merge_requests/66

Design-reviewed:

  • User goals: claim/share referral code, understand flat referral CRED, inspect indexed CRED/leaderboard state, identify external venue trust boundaries, and recover from 404/fallback routes to Time Arena/AUDIT.
  • Surfaced actions: register/copy/track CRED on /referrals; open external venue or return to Time Arena/AUDIT on Kumbaya/Sir; Time Arena/AUDIT recovery on fallbacks.
  • Removed stale assumptions: visible TimeCurve share-path labeling, verbose arcade placeholder copy, legacy BPS/CHARM-boost referral framing, and any venue copy implying third-party data is authoritative.

Acceptance / verification:

  • Referrals, venue, and 404 surfaces match the new visual system → PASS: Rabby-backed Chromium smoke on /referrals, /kumbaya, /sir, /definitely-not-a-route; targeted Playwright with 5 workers passed.
  • Referral explanations reflect current flat CRED mechanics → PASS: reviewed against docs/product/referrals.md; UI/E2E assert 5 + 5 CRED and flat referred DOUB buy copy.
  • No stale TimeCurve/sale/PvE cross-sell copy remains → PASS: E2E negative visible-copy assertion plus Rabby smoke stale-copy check on touched routes.
  • Required E2E specs updated and passing → PASS: cd frontend && CI=1 npm run test:e2e -- --workers=5 e2e/referrals-surface.spec.ts e2e/navigation.spec.ts e2e/footer-site-links.spec.ts (8 passed).
  • Docs/invariants/manual QA updated → PASS: added #296 design, invariant, manual QA, and referrals doc crosslinks; bash scripts/check-doc-anchors.sh passed.

Commands / checks:

  • cd frontend && npm run typecheck → PASS
  • cd frontend && npm run lint → PASS (0 errors; 9 pre-existing warnings)
  • cd frontend && npm test → PASS (108 files / 553 tests)
  • cd frontend && npm run build → PASS
  • cd frontend && CI=1 npm run test:e2e -- --workers=5 e2e/referrals-surface.spec.ts e2e/navigation.spec.ts e2e/footer-site-links.spec.ts → PASS
  • bash scripts/check-doc-anchors.sh → PASS
  • Rabby/Chromium visual smoke via launchRabbyContext and xvfb-run → PASS (/referrals, /kumbaya, /sir, 404, and /referrals 390x844 no-overflow)

Issue left open for maintainer/product acceptance.

Implemented #296 in MR !436: https://gitlab.com/PlasticDigits/yieldomega/-/merge_requests/66 Design-reviewed: - User goals: claim/share referral code, understand flat referral CRED, inspect indexed CRED/leaderboard state, identify external venue trust boundaries, and recover from 404/fallback routes to Time Arena/AUDIT. - Surfaced actions: register/copy/track CRED on `/referrals`; open external venue or return to Time Arena/AUDIT on Kumbaya/Sir; Time Arena/AUDIT recovery on fallbacks. - Removed stale assumptions: visible TimeCurve share-path labeling, verbose arcade placeholder copy, legacy BPS/CHARM-boost referral framing, and any venue copy implying third-party data is authoritative. Acceptance / verification: - Referrals, venue, and 404 surfaces match the new visual system → PASS: Rabby-backed Chromium smoke on `/referrals`, `/kumbaya`, `/sir`, `/definitely-not-a-route`; targeted Playwright with 5 workers passed. - Referral explanations reflect current flat CRED mechanics → PASS: reviewed against `docs/product/referrals.md`; UI/E2E assert `5 + 5 CRED` and flat referred DOUB buy copy. - No stale TimeCurve/sale/PvE cross-sell copy remains → PASS: E2E negative visible-copy assertion plus Rabby smoke stale-copy check on touched routes. - Required E2E specs updated and passing → PASS: `cd frontend && CI=1 npm run test:e2e -- --workers=5 e2e/referrals-surface.spec.ts e2e/navigation.spec.ts e2e/footer-site-links.spec.ts` (8 passed). - Docs/invariants/manual QA updated → PASS: added #296 design, invariant, manual QA, and referrals doc crosslinks; `bash scripts/check-doc-anchors.sh` passed. Commands / checks: - `cd frontend && npm run typecheck` → PASS - `cd frontend && npm run lint` → PASS (0 errors; 9 pre-existing warnings) - `cd frontend && npm test` → PASS (108 files / 553 tests) - `cd frontend && npm run build` → PASS - `cd frontend && CI=1 npm run test:e2e -- --workers=5 e2e/referrals-surface.spec.ts e2e/navigation.spec.ts e2e/footer-site-links.spec.ts` → PASS - `bash scripts/check-doc-anchors.sh` → PASS - Rabby/Chromium visual smoke via `launchRabbyContext` and `xvfb-run` → PASS (`/referrals`, `/kumbaya`, `/sir`, 404, and `/referrals` 390x844 no-overflow) Issue left open for maintainer/product acceptance.
PlasticDigits commented 2026-06-07 09:07:30 +00:00 (Migrated from gitlab.com)

Design-review and verification follow-up for #296 after merged MR !436.

What I reviewed:

  • Issue title/body/comments via glab issue view 296 -R PlasticDigits/yieldomega --comments.
  • Product/design docs: docs/product/referrals.md, docs/product/time-arena.md, docs/product/arena-v2.md, docs/frontend/design.md, docs/frontend/arena-views.md, docs/testing/invariants-and-business-logic.md, and docs/testing/manual-qa-checklists.md.
  • UI/code surfaces: /referrals page and referral register/leaderboard/CRED panels, third-party venue page, 404 page, under-construction component, #296 CSS, and required E2E specs.

Design review notes:

  • Primary user goals are to claim/share a referral code, understand the flat referral CRED rule quickly, track guide/buyer CRED from indexed state, identify Kumbaya/Sir as external venues, and recover from missing/future routes to Time Arena or AUDIT.
  • Primary decisions/actions are visible and action-first: register/share/track CRED on /referrals, open external venue or return to Time Arena/AUDIT on venue pages, and recover via Time Arena/AUDIT on fallback routes.
  • Stale assumptions removed/kept out: no visible TimeCurve path labeling, no sale-end/redemption/launchpad/PvE cross-sell framing, no legacy BPS or CHARM referral boost claims, and third-party venue reads stay labeled external/non-authoritative.

Acceptance / verification:

  • Referrals, venue, and 404 surfaces match the new visual system → PASS. Current main includes merged MR !436; Cursor browser MCP smoke on built preview checked /referrals, /kumbaya, /sir, /definitely-not-a-route, and mobile /referrals.
  • Referral explanations reflect current flat CRED mechanics → PASS. Docs and UI match docs/product/referrals.md: one-time 1 CL8Y burn, one code, flat 5 CRED to guide + 5 CRED to buyer on referred DOUB buys.
  • No stale TimeCurve/sale/PvE cross-sell copy remains on touched visible surfaces → PASS. rg checks on touched files found no stale visible copy; E2E negative assertion remains present; browser MCP mobile DOM check returned stale: false.
  • Required E2E specs updated and passing → PASS. referrals-surface.spec.ts, navigation.spec.ts, and footer-site-links.spec.ts are updated and passed with 5 workers.
  • Docs/invariants/manual QA guidance updated → PASS. #296 design contract, invariant mapping, product referral crosslinks, and manual QA checklist are present; doc anchors pass.
  • Accessibility/responsive → PASS. Route actions are native links/buttons with existing focus-ring styling; AddressInline is used for leaderboard rows; 390x844 /referrals browser MCP check reported clientWidth: 390, scrollWidth: 390, overflowX: false.
  • Under-construction fallback pattern → PASS by code review. UnderConstruction uses the same placeholder/cutout glass treatment and immediate Time Arena/AUDIT recovery actions; no current route mounts it for live browser navigation.

Commands / logs:

  • glab issue view 296 -R PlasticDigits/yieldomega --comments → PASS.
  • glab mr view 66 -R PlasticDigits/yieldomega → PASS; MR !436 is merged.
  • cd frontend && npm run typecheck → PASS.
  • cd frontend && npm run lint → PASS, 0 errors / 9 existing warnings.
  • cd frontend && npm test → PASS.
  • cd frontend && npm run build → PASS.
  • cd frontend && CI=1 npm run test:e2e -- --workers=5 e2e/referrals-surface.spec.ts e2e/navigation.spec.ts e2e/footer-site-links.spec.ts → PASS, 8 passed.
  • bash scripts/check-doc-anchors.sh → PASS, 57 anchors / no broken links.
  • Cursor browser MCP built-preview smoke → PASS for expected copy/actions/trust boundaries/no overflow on checked routes.

No new code/doc changes or new MR are needed. All acceptance criteria pass, so I am closing #296 for merged MR !436 and this verification pass.

Design-review and verification follow-up for #296 after merged MR !436. What I reviewed: - Issue title/body/comments via `glab issue view 296 -R PlasticDigits/yieldomega --comments`. - Product/design docs: `docs/product/referrals.md`, `docs/product/time-arena.md`, `docs/product/arena-v2.md`, `docs/frontend/design.md`, `docs/frontend/arena-views.md`, `docs/testing/invariants-and-business-logic.md`, and `docs/testing/manual-qa-checklists.md`. - UI/code surfaces: `/referrals` page and referral register/leaderboard/CRED panels, third-party venue page, 404 page, under-construction component, #296 CSS, and required E2E specs. Design review notes: - Primary user goals are to claim/share a referral code, understand the flat referral CRED rule quickly, track guide/buyer CRED from indexed state, identify Kumbaya/Sir as external venues, and recover from missing/future routes to Time Arena or AUDIT. - Primary decisions/actions are visible and action-first: register/share/track CRED on `/referrals`, open external venue or return to Time Arena/AUDIT on venue pages, and recover via Time Arena/AUDIT on fallback routes. - Stale assumptions removed/kept out: no visible TimeCurve path labeling, no sale-end/redemption/launchpad/PvE cross-sell framing, no legacy BPS or CHARM referral boost claims, and third-party venue reads stay labeled external/non-authoritative. Acceptance / verification: - Referrals, venue, and 404 surfaces match the new visual system → PASS. Current `main` includes merged MR !436; Cursor browser MCP smoke on built preview checked `/referrals`, `/kumbaya`, `/sir`, `/definitely-not-a-route`, and mobile `/referrals`. - Referral explanations reflect current flat CRED mechanics → PASS. Docs and UI match `docs/product/referrals.md`: one-time 1 CL8Y burn, one code, flat 5 CRED to guide + 5 CRED to buyer on referred DOUB buys. - No stale TimeCurve/sale/PvE cross-sell copy remains on touched visible surfaces → PASS. `rg` checks on touched files found no stale visible copy; E2E negative assertion remains present; browser MCP mobile DOM check returned `stale: false`. - Required E2E specs updated and passing → PASS. `referrals-surface.spec.ts`, `navigation.spec.ts`, and `footer-site-links.spec.ts` are updated and passed with 5 workers. - Docs/invariants/manual QA guidance updated → PASS. #296 design contract, invariant mapping, product referral crosslinks, and manual QA checklist are present; doc anchors pass. - Accessibility/responsive → PASS. Route actions are native links/buttons with existing focus-ring styling; `AddressInline` is used for leaderboard rows; 390x844 `/referrals` browser MCP check reported `clientWidth: 390`, `scrollWidth: 390`, `overflowX: false`. - Under-construction fallback pattern → PASS by code review. `UnderConstruction` uses the same placeholder/cutout glass treatment and immediate Time Arena/AUDIT recovery actions; no current route mounts it for live browser navigation. Commands / logs: - `glab issue view 296 -R PlasticDigits/yieldomega --comments` → PASS. - `glab mr view 66 -R PlasticDigits/yieldomega` → PASS; MR !436 is merged. - `cd frontend && npm run typecheck` → PASS. - `cd frontend && npm run lint` → PASS, 0 errors / 9 existing warnings. - `cd frontend && npm test` → PASS. - `cd frontend && npm run build` → PASS. - `cd frontend && CI=1 npm run test:e2e -- --workers=5 e2e/referrals-surface.spec.ts e2e/navigation.spec.ts e2e/footer-site-links.spec.ts` → PASS, 8 passed. - `bash scripts/check-doc-anchors.sh` → PASS, 57 anchors / no broken links. - Cursor browser MCP built-preview smoke → PASS for expected copy/actions/trust boundaries/no overflow on checked routes. No new code/doc changes or new MR are needed. All acceptance criteria pass, so I am closing #296 for merged MR !436 and this verification pass.
PlasticDigits (Migrated from gitlab.com) closed this issue 2026-06-07 09:07:31 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
cac-design-issue-544
renovate/configure
No results found.
Labels
Clear labels   
agent:fix_bugfix

   
agent:fix_conflicts

   
agent:fix_security

   
agent:gap_analysis

   
agent:implement

   
agent:open_issues

   
agents

   
agent:security_audit

   
agent:verify
  
area
timecurve

  
arena

   
arena-v2

   
audit

   
block:feature_review

   
block:security

   
bug

   
contracts

   
design

   
devops

   
docs
Documentation

  
documentation

   
enhancement

   
epic
Epic / umbrella issue

  
feature

   
frontend

   
indexer

   
low priority
Low priority, investigate other issues first

  
megaeth

   
operations

   
ops
Deploy and operations

  
performance

   
QA

   
qa checklist

   
referrals

   
removal
Legacy removal

  
security

   
smart-contracts

   
tech-debt

   
testing

   
time-arena
TimeArena v2 revamp

  
timecurve

   
visual-qa
No labels
agent:fix_bugfix
agent:fix_conflicts
agent:fix_security
agent:gap_analysis
agent:implement
agent:open_issues
agents
agent:security_audit
agent:verify
area
timecurve
arena
arena-v2
audit
block:feature_review
block:security
bug
contracts
design
devops
docs
documentation
enhancement
epic
feature
frontend
indexer
low priority
megaeth
operations
ops
performance
QA
qa checklist
referrals
removal
security
smart-contracts
tech-debt
testing
time-arena
timecurve
visual-qa
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
code/yieldomega#296
No description provided.