> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claimr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pop-ups UX requirements

> UX design requirements for pop-ups within your Claimr campaigns, covering login, wallet connect, task completion, challenges, leaderboard, and notifications.

Pop-ups provide a way to deliver important information or enable focused interactions within your Claimr campaigns.

## General requirements

* **Purposeful use:** Use pop-ups sparingly and only when necessary to avoid disrupting the user flow.
* **Clear close option:** Provide a prominent and easily accessible close button.
* **Visual hierarchy:** Use headings, subheadings, and bullet points to organize content.
* **Mobile optimization:** Ensure pop-ups are responsive and adapt well to smaller screens.
* **Accessibility:** Design with accessibility in mind, including appropriate color contrast, keyboard navigation, and screen reader compatibility.

## Login

<Frame caption="Example: Login pop-up">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/login-popup-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=a0c45bf81244ee0a62ac9e7b41fc23e1" alt="Example login pop-up" width="1002" height="460" data-path="images/ux-requirements/login-popup-example.png" />
</Frame>

* **Clear purpose:** Explain why login is required and its benefits.
* **Multiple options:** Offer various login methods (e.g., email, social media).
* **Error handling:** Provide clear error messages and guidance.

## Wallet connect

<Frame caption="Example: Wallet connect pop-up">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/wallet-connect-popup-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=9c0e3626801db7c48d5757426fa8dcf6" alt="Example wallet connect pop-up" width="938" height="1370" data-path="images/ux-requirements/wallet-connect-popup-example.png" />
</Frame>

* **Clear instructions:** Provide step-by-step instructions on how to connect a wallet.
* **Supported wallets:** Display a list of supported wallets and their logos.
* **Security information:** Assure users about the security of their wallet connection.
* **Error handling:** Provide clear error messages and troubleshooting tips if connection issues arise.

## Platform login

<Frame caption="Example: Platforms login pop-up">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/platform-login-popup-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=d5c05d835c31307cbff680d58ea1ad77" alt="Example platform login pop-up" width="714" height="1040" data-path="images/ux-requirements/platform-login-popup-example.png" />
</Frame>

* **Platform branding:** Incorporate the branding of the relevant platform for visual consistency.
* **Clear instructions:** Explain the login process and any required permissions.
* **Error handling:** Display clear error messages if login attempts fail.

## Email login

* **Clear input fields:** Provide well-labeled input fields for email and password.
* **Password recovery:** Include a "Forgot Password" link for users who need assistance.
* **Error handling:** Display clear error messages if login attempts fail.

## Completed task

<Frame caption="Example: Completed task pop-up">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/completed-task-popup-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=b3a29f7d61d612576d277bcc158fdabc" alt="Example completed task pop-up" width="1106" height="998" data-path="images/ux-requirements/completed-task-popup-example.png" />
</Frame>

* **Congratulatory message:** Celebrate the user's achievement.
* **Reward display:** Clearly showcase the earned reward.
* **Call to action (CTA):** Encourage further progress or exploration.

## Challenge details

<Frame caption="Example: Challenge details pop-up">
  <img src="https://mintcdn.com/claimr/dhPADok3uWVS7HZR/images/ux-requirements/challenge-details-popup-example.png?fit=max&auto=format&n=dhPADok3uWVS7HZR&q=85&s=dea0905f2457b1d85381c2f49ccaa31c" alt="Example challenge details pop-up" width="1808" height="972" data-path="images/ux-requirements/challenge-details-popup-example.png" />
</Frame>

* **Challenge information:** Clearly present the challenge's objectives, rules, rewards, and any time constraints.
* **Progress tracking:** Include a progress bar or indicator to show the user's advancement towards the challenge goal.
* **CTA:** Include a "Participate" or similar button to prompt users to join the challenge.

## Leaderboard

* **Default view:** Displays the full leaderboard with all ranked users visible.
* **Collapsed leaderboard state:** Only the heading row and the top 9 ranked users are shown when the list is long. Include **View more** / **Hide** buttons to expand or collapse the list.

<Frame>
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/leaderboard-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=b4cba2f4261d8434e26d43a7dc11639d" alt="Example leaderboard" width="1142" height="1096" data-path="images/ux-requirements/leaderboard-example.png" />
</Frame>

* **Leaderboard pop-up:** Design the button for flows when the leaderboard appears only after clicking it.

<Frame>
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/leaderboard-popup-button-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=722fc6efc05781b53eb5862917b14c6a" alt="Example leaderboard pop-up button" width="388" height="72" data-path="images/ux-requirements/leaderboard-popup-button-example.png" />
</Frame>

* **Collapse button in pop-up:** When opened in a modal, include an option to collapse or minimize the leaderboard view.
* **Pagination:** If the full list is too long to load at once, add pagination to allow users to browse through pages of results.

<Frame>
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/leaderboard-pagination-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=b226e449308967a2f0068b9716a07d91" alt="Example leaderboard pagination" width="918" height="448" data-path="images/ux-requirements/leaderboard-pagination-example.png" />
</Frame>

* **Clear rankings:** Present user rankings and relevant metrics clearly.
* **Visual hierarchy:** Use size, color, and placement to highlight top performers.

## Action status notifications

* **Concise message:** Provide a brief message about the action's status.
* **Visual cues:** Use colors, icons, or animations for visual feedback.
* **Additional information:** Include relevant details or instructions.
