# Quick Start

This section provides a brief tutorial on how to quickly create a competition. Each step of the process is accompanied by additional links to articles with a full description of features. Let's get started!

{% hint style="warning" %}
The section consists of modules that describe how to set up the competition step-by-step. Thus you start setting up a competition with the **How to Create a Competition** module and end the process with the **How to Publish a Competition** module.
{% endhint %}

## How to Create a Competition

After registering on the platform as an organizer, you will see the **My Competitions** page. On this page, click on the **Create competition** button and select a template. We will use a template with the **Hackathon** type.

![](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2F3mlZn3Rzow25IWbgm1SJ%2Fq%20start%20create%20con1?alt=media)

## Setting up a Competition

Now let's start setting up our competition. After creating a competition, you will be automatically forwarded to the created competition and the first thing you will see is competition settings.

### Main Tab

![](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2FoAyyoEDQ4FqL4lIIZOsw%2Fq%20start%20main%20tab?alt=media)

The **Main** tab consists of the main settings of the competition.

Enter the name of your competition in the **Title** field. Add a unique link to your competition in the **URL** field.

Select the competition type if you created it without a template, and assign tags to your competition. Add the SEO description and upload the SEO image to make the link to your competition look better on social media.

Do you want your competition to be seen only by people you invite yourself? In order to do this, select the desired setting in the **Visibility** field. To make it easier for participants to find a competition by location, select the appropriate value in the **Location** field.

Don't forget to fill in the Prize field! Set the start and end dates for the competition and for the registration of participants.

* [What is the Title field for?](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#title-field)
* [What is the URL field for?](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#url-field)
* [What is the Type field for?](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#type-field)
* [What do I need tags for?](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#tags-field)
* [Why do I need SEO settings?](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#seo-description-and-seo-image-fields)
* [Competition Visibility](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#visibility-field)
* [The Location setting](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#location-field)
* [The Prize field. What should I write there?](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#prize-field)
* [Registration start / End of registration and Start of event/End of event](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#fields-registration-start-end-of-registration-and-start-of-event-end-of-event)

An example of how to fill in the **Main** tab is presented here - [An example of filling in the Main tab](https://tulula.gitbook.io/docs/setting-up-a-competition/main-tab#the-example-of-how-to-fill-in-the-main-tab).

### Other tab

The **Other** tab includes other parameters to make your competition more fine-tuned.

![](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2FoPC1rkq6AoUpOTYMi2fh%2Fq%20start%20other%20t?alt=media)

Enter in the fields **Max./Min. number of participants per team** the number to limit the number of team participants at your competition.

{% hint style="info" %}
Please note that the number in the field **Minimum number of participants per team** as opposed to the number in the field **Maximum number of participants per team** is informational in nature and does not affect the number of people in the team.
{% endhint %}

* [How to set the limits for team participants number?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#fields-maximum-number-of-participants-per-team-and-minimum-number-of-participants-per-team)

Consider whether you want to show the rating page to participants or not. In order to do this, select the desired value in the field **Publish rating**.

* [The Publish rating setting](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#publish-rating-setting)

The **Publish solutions** setting works only in competitions with the type **Competition of Projects**. It is used to ensure that the solutions published by the participants are seen by the rest of the contest participants. We wouldn’t need it for the hackathon, so you should leave it disabled.

* [How to show the solutions of participants in the competition of projects?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#publish-solutions-setting)

Enable the **Team moderation** setting if you need to moderate teams before allowing them to participate in the competition. The Limit task selection setting disables the selection of multiple tasks - each team can only select one task from the list.

* [Moderation of teams. How should it be done?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#team-moderation-setting)
* [One task per team. A quick setup!](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#limit-task-selection-setting)

Do you want to restrict the team from changing its composition and from changing the task whenever it wants? Enable the **Fix team settings** and after passing moderation, the team settings will be locked.

* [How to fix the team settings and its composition?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#fix-team-settings-setting)

The **Show the number of registered participants** setting displays the number of participants on the main page of the competition and on the competition preview card in the list of all competitions.

* [How to set up Show the number of registered participants?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#show-the-number-of-registered-participants-setting)

Enable the **Allow registration by link to the team after registration closes** setting if you want to allow participants to invite other participants to join the team after registration ends.

* [How to allow participants to register after the end of the registration?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#allow-registration-by-link-to-the-team-after-registration-closes-setting)

Do you need additional confirmation that the participant will definitely participate in the contest? Enable the **Enable confirmation of participation** setting. Now you can send confirmation links to emails or via Telegram.

* [Confirmation of participation](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#enable-confirmation-of-participation-setting)

Enable the **Consider the time spent on the solution when forming the rating** setting, so that the rating takes into account the time participants spent on solving the problem.&#x20;

The scores of the participants could be the same, but what if one of the participants solved the problem just a second earlier? With this setting enabled, he's a winner! The setting **Team chooses the type of participation** adds a field enabling teams to select the type of participation. This field in the team preview card is for informational purposes only.

* [How to take time spent on solving tasks into account?](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#consider-the-time-spent-on-the-solution-when-forming-the-rating-setting)&#x20;
* [The team chooses the type of participation](https://tulula.gitbook.io/docs/setting-up-a-competition/other-tab#team-chooses-the-type-of-participation-setting)

An example of how to fill in the tab **Other**. Now you are familiar with each setting of this tab and can choose what to enable and what to disable. Next tab - **Integration**.

### Integrations Tab

The **Integrations** tab allows you to connect Facebook pixels and etc., the Telegram bot and to request help with connecting to third-party services. If you don't require this connection, then just click **Next**.

**Do you want to send bulk notifications to participants in Telegram?** Activate the checkbox **Telegram bot**. Now participants who have confirmed their Telegram accounts will receive notifications from the bot.

### Menu Tab

Edit the menu of your competition in the **Menu** tab. Create a new menu item, change the order of items, delete unnecessary ones, or hide them from participants. For example, you can add an item with a link to any URL.

![](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2FenHJUbxVjJvm3xcv9n7z%2Fqs%20menu%20tab1?alt=media)

### Actions Tab

In the **Actions** tab, you will see the button to delete the competition. If you are not planning to do this, then skip this tab. So, we went through all the tabs and set up the competition. Click on **Save** button to save the competition settings.

### How to Upload the Competition Banner

After setting up the competition, you need to upload the competition banner.

Go to competition editing mode and click on the demo banner next to the competition name. Select a file, cut out what you don't need, and upload it to the platform.

![](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2FaP35NTF99esgKAWwzNJp%2Fqs%20banner%20down?alt=media)

### Competition Pages: About, Rules, FAQ

It's time to fill in the pages with information about the competition. There are only three of them here: **About**, **Rules** and **FAQ**.

![alt](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2F02wQOrIMBdGNexi6WYZk%2Fqs%20about%20page?alt=media)

The **About** and **Rules** pages are identical. Both pages provide a functional text editor that will satisfy even the most demanding user. So, paste and format your text, upload images and videos for participants. Do whatever your heart desires (within reason, of course)!

After editing the text, click **Save** to apply the changes.

{% hint style="info" %}
Note that you can choose the items in the competition menu yourself and, if you want, then the menu items and the About and Rules pages will not be displayed.
{% endhint %}

The **FAQ** page is to answer frequently asked questions from users. Go to the **FAQ** page and click on the **Add a question** button. Enter your questions and answers and post them. Everything you wanted to know about the **FAQ** page, but were afraid to ask, can be found at the link below.

The next step is to create a registration form!

### How to create a registration form for participants

The registration form is designed to collect information about the contest participants that is of interest to you. For example, it is very convenient for finding out the size of a participant's clothing, so that you don't screw up when giving out a prize.

* [My contest doesn't need a registration form. How can I disable it?](https://tulula.gitbook.io/docs/setup-guide/setting-up-a-competition/registration-form-page)

Go to the **Form** page and select additional ready-made fields from the list.

{% hint style="info" %}
Please note that the fields **Name**, **Surname**, **Email** you don’t need to create, because this information is automatically collected during registration.
{% endhint %}

* [Additional fields – easy and convenient!](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#additional-questions)
* [The Public information block. How to use it correctly.](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#set-of-questions-public-information)
* [The question How will you participate?](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#the-question-how-will-you-participate)

You can add your own fields to the registration form. Click on **Add your question** and select the appropriate question type. Fill in the question field and select the answer options, if any.

* [How to add your own question to the registration form](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#add-your-question-button)
* [How to differentiate various types of questions](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#types-of-questions)

You can drag and drop questions, delete them, and change the type of question you've already created. All settings are located inside the question preview card.

* [Actions with questions](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#what-can-you-do-with-questions)

If you need to redirect participants to a certain page of the contest after they complete filling out the registration form, then select the appropriate option in the block **Redirect after filling out the questionnaire**.

* [Redirecting participants after they fill out the form or simply showing them the right direction](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#redirect-after-filling-out-the-questionnaire)

You can upload the required policies and notifications to the Contest Files section. Links to them will appear when a participant is registered for the contest.

* [Example of creating a registration form](https://tulula.gitbook.io/docs/setting-up-a-competition/registration-form-page#example-of-creating-a-registration-form)

## Creating tasks

One of the most important tasks of the organizer is to create tasks for participants.

{% hint style="warning" %}
**Attention!** Here you will find brief information on creating tasks. Please refer to the relevant section of the documentation for the most comprehensive description of this feature.
{% endhint %}

A demo **task** will be created automatically on the Tasks page. Click on **Edit**. Set up the task: enter a name, set the opening and closing times for the task, and add experts and meeting intervals.

* [Task Editor](https://tulula.gitbook.io/docs/setting-up-a-competition/tasks-page#task-editor)
* [Creating intervals for meeting with the expert](https://tulula.gitbook.io/docs/setting-up-a-competition/tasks-page#meetings-schedule)

Now you need to add questions to the task. There are several types of questions: **Test**, **Text**, **File**, **Video** **Pitching**, **Live Coding**, **GitLab**. Add the appropriate question types and set them up.

* [How to differentiate the types of questions!](https://tulula.gitbook.io/docs/setting-up-a-competition/tasks-page#types-of-questions)

Save the task after adding the questions.

* [How to save a task, the example of filling in task information.](https://tulula.gitbook.io/docs/setting-up-a-competition/tasks-page#completing-the-process-of-task-creation)

The next step is to create voting!

## How to create voting

Go to the **Voting page**. There are three tabs on the page: **Juries**, **Criteria**, and **Voting**.

![alt](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2F3hN3FANPtClIe1C4YTGK%2Fqs%20voting?alt=media)

### The Juries

The **Juries** tab is for adding and managing jury members. Go inside the tab and click **Add jury**. Enter the required information and save it.

* [The Juries tab](https://tulula.gitbook.io/docs/setting-up-a-competition/voting-page#juries)

Next to each jury member you will see the icons that will help you to manage them. You can edit the information about the jury member, send an invitation to vote, delete the jury member, and clear the vote.

* [How to manage the jury members](https://tulula.gitbook.io/docs/setting-up-a-competition/voting-page#juries-settings)

### Criteria

The next step is to create criteria for task assessment. Go to the **Criteria** tab and click on the **Add group** button. Enter the name of the criteria group and start creating criteria within the group. Don't forget to specify the maximum number of scores for each criterion.

![alt](https://2443639464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYhmDSxGwE0XjiVL1pYV%2Fuploads%2FtxmdL3YW8SIVP0ZPSAa0%2Fqs%20add%20crit?alt=media)

Enable the **Request a comment on assessment** setting, if you want the jury members to leave comments on their assessments.

After creating the criteria, click **Save Criteria**. You can change the criteria settings at any time.

* [All the secrets of creating voting criteria](https://tulula.gitbook.io/docs/setting-up-a-competition/voting-page#how-to-add-criteria)

### Voting

Let's start setting up voting! Go to the **Voting** tab and click on the **Create voting** button.

How to set up voting: set the start and end dates of voting, add a jury member and attach criteria to them, add teams.

* [How to create and configure voting from A to Z](https://tulula.gitbook.io/docs/setting-up-a-competition/voting-page#how-to-create-and-configure-the-voting)

After completing the setup of voting, click **Update**. Go to the **Juries** and send the jury members invitations to vote (airplane icon).

Voting is ready! Make sure to read the voting example below:

* [Example of how to set up voting](https://tulula.gitbook.io/docs/setting-up-a-competition/voting-page#how-to-conduct-the-voting)

### How to publish a Сompetition

It's time to show your competition to the world! Click on the **Publishing** button and wait for moderation. Moderation takes little time! You will receive a notification email to the email address you specified during registration.

{% hint style="warning" %}
How to publish a competition If you have any problems with publishing the competition, please contact us.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tulula.gitbook.io/docs/setup-guide/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
