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

# Setup

> Learn how to create, configure, and launch your first quest.

> Launching a quest involves defining its identity, adding tasks for your community to complete, and setting up rewards.
> This guide walks you through the entire process.

## Step 1 - Create a new quest

Navigate to the **Quests** section in your community dashboard and click the **Create new quest** button.
You'll be asked to choose whether you want to create a quest from scratch or by using of the available templates.
Select **Create quest from scratch** for now. This will take you to our quest creation wizard:

<Frame caption="Quest overview">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-builder-overview.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=fe74b2c9178ced6e51cd3bb0053abd58" className="rounded-lg" width="1520" height="788" data-path="images/quests/quest-builder-overview.png" />
</Frame>

You'll be asked to provide the following details about your quest:

* **Name**: The title of your quest as it will appear to users.
* **Description**: A brief quest description that will be visible on your quest card.
* **Instructions**: Detailed instructions or context required to finish a quest.
* **Banner**: Upload a high-quality image to represent your quest.

## Step 2 - Configure quest

Decide how often users can complete this quest and if there's a cap on total completions.

<Frame caption="Quest configuration">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-builder-configuration.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=06f51ca218549f3e8e9585f7df596317" className="rounded-lg" width="1520" height="788" data-path="images/quests/quest-builder-configuration.png" />
</Frame>

You can configure the following options for your quest:

* **Visibility**: Choose if the quest should be visible to communities you collaborate with.
* **Recurrence**: Choose between `ONCE`, `DAILY`, `WEEKLY`, `MONTHLY`, or `CUSTOM` intervals.
* **Round count**: For recurring quests, how many times the quest itself can repeat.
* **Max total completions**: Global cap for all users.
* **Max round completions**: Cap per user per interval.

## Step 3 - Add tasks

Tasks are the requirements users must meet or specific actions they need to take. We already support over **20**
different task types. Click **Add task** to browse the task library.

<Frame caption="Quest task library">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-task-library.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=6db36f476e69bc2ee04eeea839cfaeab" className="rounded-lg" width="1059" height="732" data-path="images/quests/quest-task-library.png" />
</Frame>

For each task, you'll need to provide a specific configuration (e.g., the X account to follow or the minimum token
balance required to attempt the quest). You can learn more about the available task types in
the [task library](/quests/tasks).

<Frame caption="Quest tasks configuration">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-builder-tasks.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=8f06803886b6a987a929f5a017df6671" className="rounded-lg" width="1520" height="788" data-path="images/quests/quest-builder-tasks.png" />
</Frame>

<Tip>
  You can use the task verification sandbox to test task requirements against your own account to see if tasks are
  set up correctly.
</Tip>

### Task reviews

Each task you add to your quest can be toggled to require a review from your team member before it can be completed.
This is useful if a task cannot be fully verified by our system (like reviewing if a meme uploaded by a user is on-topic).

### Reward boosts

Each optional task you add to your quest can be granted a reward boost that will increase the final reward for anyone
who meets the task's requirements. It's a great way to gamify quests in your community and reward community members
who are willing to put in more effort.

<Frame caption="Reward boost task">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/reward-boost-task.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=59a89c0849e609df2c6f539e4421de2c" className="rounded-lg" width="612" height="273" data-path="images/quests/reward-boost-task.png" />
</Frame>

To make a task grant reward boost, simply check the **Optional task** and **Include reward boost** checkboxes in the
task settings like so, and configure the boost parameters:

<Frame caption="Reward boost task configuration">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/reward-boost-task-config.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=566c6202b2e115f3ff6b974cfabafd35" className="rounded-lg" width="509" height="493" data-path="images/quests/reward-boost-task-config.png" />
</Frame>

There are 3 reward boost modes you can apply to any optional task:

* **Max:** Only the highest boost from all `MAX` reward boosts is applied
* **Cumulative:** All boosts with `CUMULATIVE` mode will be added together
* **Global:** Applies on top of all other reward boosts

You are free to mix and match different reward boost modes across the same quest. The final reward multiplier for each
user is calculated using the following formula:

$$
(1 + \max(\text{MAX}) + \sum \text({CUMULATIVE})) \times (1 + \prod (\text{GLOBAL}))
$$

## Step 4 - Set up rewards

Choose how you want to reward your community. Click **Add reward** to browse the available reward types.

<Frame caption="Quest reward library">
  <img src="https://mintcdn.com/flipsuite/WS3TI9rnIexQzhY0/images/quests/quest-reward-library.png?fit=max&auto=format&n=WS3TI9rnIexQzhY0&q=85&s=3e03d339d3ea2d43dd615d68c92505e1" className="rounded-lg" width="542" height="667" data-path="images/quests/quest-reward-library.png" />
</Frame>

There are multiple reward types you can choose from:

* **Random**: Each user will get a random reward from a selected [reward pool](/rewards/reward-pools).
* **Points**: Each user will receive a specific, base amount of points.
* **Points Pool**: All users will share a pool of points.
* **Token**: Each user will receive a specific, base amount of tokens.
* **Token Pool**: All users will share a pool of tokens.
* **NFT**: Users will receive a specific NFT.
* **Role**: Users will be granted a specific role in your Discord server.
* **Custom**: Users will get a custom reward that's defined by you.

For each reward you add to your quest, you can select from the following distribution strategies that will affect
who receives the reward:

* **Everyone**: All users who complete the quest will receive the reward.
* **FCFS**: Only the first `N` users who complete the quest will receive the reward.
* **Raffle**: Only `N` random users will receive the reward once the quest ends.

<Frame caption="Quest rewards configuration">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-builder-rewards.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=3782ee2f1229e2feb495bb81ef5b653f" className="rounded-lg" width="1510" height="783" data-path="images/quests/quest-builder-rewards.png" />
</Frame>

<Tip>
  Use the spending calculator widget to estimate your potential spending based on set rewards, estimated number of
  quest completions and applied reward multipliers.
</Tip>

Make sure to get familiar with our reward system before distributing onchain rewards.

<Card title="Rewards" icon="trophy" href="/rewards/introduction" horizontal={true}>
  Click to learn how to set up rewards in Flipsuite.
</Card>

## Step 5 - Review and activate

Once the quest is configured, it's time to review and finalize it.

<Frame caption="Quest finalization">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-builder-finalize.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=5bd5bcfc019cfc3048ff801dda5e8be0" className="rounded-lg" width="1513" height="706" data-path="images/quests/quest-builder-finalize.png" />
</Frame>

If everything looks good, click **Save quest** to create the quest. Once created, your quest will be in the `DRAFT`
state and won't be visible to users yet. To activate your quest, simply find it in your questboard and click
the **Activate quest** button.

<Frame caption="Quest activation">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-activation.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=3bea9843838d1b1ce85e571e71404176" className="rounded-lg" width="1510" height="664" data-path="images/quests/quest-activation.png" />
</Frame>

You will be asked again to validate the quest settings before activating it, because quest tasks and rewards can't be
changed after activation. If everything looks good, click the **Activate** button to activate the quest and make it
visible to your community!

### Sharing your quest

By default, you need to use `/quest share` slash command in Discord in order to share your quest. If you want to
automate this process and push quests to respective Discord channels automatically, head over to the
quest settings and configure channels for automatic sharing.

<Frame caption="Quest sharing settings">
  <img src="https://mintcdn.com/flipsuite/cn2YMu2aibNLiFf6/images/quests/quest-sharing-settings.png?fit=max&auto=format&n=cn2YMu2aibNLiFf6&q=85&s=1ef38b02a8c2671a7a7611fe8de0606f" className="rounded-lg" width="1509" height="719" data-path="images/quests/quest-sharing-settings.png" />
</Frame>

Alternatively, you can choose a Discord channel to share your quest in when activating it.
This will override the channels you've set in the quest sharing settings.
