> ## 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.

# Quest card UX requirements

> Key design elements and considerations for creating effective and engaging quest cards in your Claimr campaigns.

## Understanding Quest cards

Quest cards serve as the primary interface for users to interact with individual quests within your campaign. Each card should provide a clear overview of the quest's objectives, rewards, and progress, enticing users to embark on the journey.

## Quest state indicators

Clearly communicate the current state of the quest: Active, Completed, or Locked.

<Frame caption="Quests at different states">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/quests-at-different-states-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=fa28567692cd2d01eb544019571bfe3d" alt="Quests at different states" width="1204" height="442" data-path="images/ux-requirements/quests-at-different-states-example.png" />
</Frame>

* **Visual clarity:** Employ distinct colors, icons, or labels to differentiate between each state.
* **Accessibility:** Ensure the indicators are easily distinguishable for users with visual impairments.
* **Consistency:** Maintain a consistent visual style for state indicators across all quests.
* **Placement:** Position these indicators prominently on the quest card.

## Image

Provides a visual representation of the quest's theme.

<Frame caption="Example: Quest card with an image">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/quest-card-with-image-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=241242631532764c766e69532b57da50" alt="Example quest card with an image" width="442" height="832" data-path="images/ux-requirements/quest-card-with-image-example.png" />
</Frame>

* **Relevance and quality:** Choose high-quality images that are relevant to the quest's content.
* **Size and aspect ratio:** Ensure the image is appropriately sized and cropped.
* **Accessibility:** Provide alternative text descriptions for images.

## Quest name

Clearly and concisely conveys the essence of the quest.

* **Clarity:** Use action-oriented language and avoid jargon.
* **Length:** Keep the title short enough to fit within the card's layout.
* **Hierarchy:** Use a larger font size and/or bolder font weight to distinguish the title.

## Short quest description

Provides a brief overview of the quest's objectives and rewards.

* **Conciseness:** Craft a succinct description.
* **Clarity:** Use plain language and avoid technical terms.
* **Enticement:** Use persuasive language to encourage participation.

## User progress bar

Visually represents the user's progress towards completing the quest.

<Frame caption="Example: Quest name, user progress bar, rewards, and counter">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/quest-card-progress-bar-rewards-counter-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=31e60f12e67e0ae855bf7df69e26e7af" alt="Example quest name, user progress bar, rewards, and counter" width="828" height="290" data-path="images/ux-requirements/quest-card-progress-bar-rewards-counter-example.png" />
</Frame>

* **Clarity:** Use a clear and easily understandable progress indicator.
* **Visual feedback:** Provide updates to the progress bar as the user completes tasks.
* **Accessibility:** Ensure the progress bar is accessible to screen readers.

## Counters

Display numerical information related to the quest, such as the number of tasks completed or rewards earned.

* **Clarity:** Use clear labels and units of measurement.
* **Placement:** Position counters near relevant elements.

## Rewards

Showcase the rewards that users can earn by completing the quest.

* **Visual appeal:** Use high-quality images or icons to represent the rewards.
* **Clarity:** Clearly indicate the type and quantity of rewards offered.

## CTA button

Prompts users to take action and start or continue the quest.

<Frame caption="Example: CTA buttons for different states">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/quest-card-cta-buttons-states-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=f756eb4f05add8a3a0858759068b353f" alt="Example CTA buttons for different states" width="1248" height="78" data-path="images/ux-requirements/quest-card-cta-buttons-states-example.png" />
</Frame>

* **Clarity:** Use action-oriented language.
* **Visual prominence:** Make the button stand out.
* **Accessibility:** Ensure the button is easily clickable.
* **State differentiation:** Visually distinguish between active and inactive states.

## Quest blockers and dependencies

Display any conditions or requirements that must be met before a user can start or continue a quest.

<Frame caption="Example: Quest card with dependencies">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/quest-card-with-dependencies-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=f95d45bc38330b1212bdadd59c77fbcf" alt="Example quest card with dependencies" width="468" height="722" data-path="images/ux-requirements/quest-card-with-dependencies-example.png" />
</Frame>

* **Clarity:** Clearly communicate the blockers and any actions the user needs to take. Show any other quests that must be completed before this quest can be unlocked.
* **Visual cues:** Use icons or labels to visually distinguish blockers.

## Countdown

Displays a timer for time-sensitive quests.

<Frame caption="Example: Quest card with a countdown timer">
  <img src="https://mintcdn.com/claimr/SqDb6Tuo_fYS0Je_/images/ux-requirements/quest-card-with-countdown-timer-example.png?fit=max&auto=format&n=SqDb6Tuo_fYS0Je_&q=85&s=383b1033e80c97663c2737bfd92f116d" alt="Example quest card with a countdown timer" width="476" height="732" data-path="images/ux-requirements/quest-card-with-countdown-timer-example.png" />
</Frame>

* **Clarity:** Use a large, easy-to-read font and clear time units.
* **Urgency:** Consider using color or animation to create a sense of urgency.
