feat: add back button to referral screen with history fallback logic

[ldsgroups225]

Summary by CodeRabbit

• New Features

  • Added a back button to the Referral Screen that navigates to the previous page if available; otherwise, returns to the app home.

• Documentation

  • Added product requirements and task documentation for the referral screen back button implementation.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

A back button feature was added to the Referral screen. The ReferralsPage component now uses the router's history to conditionally navigate backward if prior navigation history exists, otherwise defaults to navigating to /app. The AppHeader component was updated with a new showBackButton prop to enable the button.

Changes

Cohort / File(s)	Summary
Referral Back Button Implementation apps/user-application/src/routes/_auth/app/referrals.tsx	Added useRouter hook initialization, handleBack function that checks router.history.length to decide between back navigation or /app fallback, and wired AppHeader's showBackButton and onBackClick props
Documentation tasks/prd-referral-back-button.md, tasks/tasks-referral-back-button.md	Added PRD and task documentation covering back button UI behavior, navigation logic, acceptance criteria, and implementation approach

Sequence Diagram

sequenceDiagram
    participant User
    participant ReferralsPage
    participant AppHeader
    participant Router

    User->>AppHeader: Click Back Button
    AppHeader->>ReferralsPage: onBackClick()
    ReferralsPage->>Router: Check router.history.length
    
    alt History exists
        Router->>Router: history.back()
    else No history
        Router->>Router: navigate to /app
    end
    
    Router->>User: Navigate to destination

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

🐰 Nose twitches with delight
A back button appears, shiny and bright!
Through the warren of pages we hop and we flee,
When lost, we retreat—to /app or history! 🔙✨

✨ Finishing touches

• 📝 Generate docstrings

---

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e17f131 and 866b8ba.

📒 Files selected for processing (3)

• apps/user-application/src/routes/_auth/app/referrals.tsx
• tasks/prd-referral-back-button.md
• tasks/tasks-referral-back-button.md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}