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

# Szybki start

> Rozpocznij pracę z Hey Quiz w 5 minut

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/heyquiz/images/hero-quickstart.png" alt="Hey Quiz - Szybki start" />
</Frame>

## Rejestracja i logowanie

<Steps>
  <Step title="Utwórz konto" icon="user-plus">
    1. Wejdź na [heyquiz.pro](https://heyquiz.pro)
    2. Kliknij **"Zarejestruj się"**
    3. Wypełnij formularz: imię, nazwisko, e-mail, hasło
    4. Zaakceptuj regulamin i politykę prywatności
    5. Kliknij **"Zarejestruj"**
  </Step>

  <Step title="Aktywuj konto" icon="envelope-open-text">
    1. Sprawdź swoją skrzynkę e-mail (również folder spam)
    2. Kliknij link aktywacyjny w wiadomości
    3. Twoje konto jest gotowe!
  </Step>

  <Step title="Zaloguj się" icon="right-to-bracket">
    1. Wejdź na [heyquiz.pro/login](https://heyquiz.pro/login)
    2. Podaj e-mail i hasło
    3. Kliknij **"Zaloguj się"**
  </Step>
</Steps>

<Note>
  **Weryfikacja dwuetapowa (2FA)**: Przy pierwszym logowaniu z nowego urządzenia możesz otrzymać kod weryfikacyjny na e-mail. To dodatkowe zabezpieczenie Twojego konta.
</Note>

***

## Twój pierwszy quiz

<Tabs>
  <Tab title="Ręczne tworzenie" icon="pencil">
    <Steps>
      <Step title="Przejdź do Moje quizy" icon="folder">
        Po zalogowaniu kliknij **"Moje quizy"** w górnym menu.
      </Step>

      <Step title="Utwórz nowy quiz" icon="plus">
        Kliknij przycisk **"+ Utwórz Quiz"** w prawym górnym rogu.
      </Step>

      <Step title="Wypełnij podstawowe dane" icon="file-lines">
        * **Tytuł**: Nazwa Twojego quizu (np. "Quiz z geografii")
        * **Opis** (opcjonalnie): Krótki opis tematyki
        * Kliknij **"Utwórz"**
      </Step>

      <Step title="Dodaj pytania" icon="circle-question">
        1. Kliknij **"Dodaj pytanie"**
        2. Wybierz typ pytania (np. Jednokrotny wybór)
        3. Wpisz treść pytania
        4. Dodaj odpowiedzi i zaznacz poprawną
        5. Ustaw czas (domyślnie 20s) i punkty (domyślnie 1000)
        6. Powtórz dla kolejnych pytań
      </Step>

      <Step title="Zapisz quiz" icon="floppy-disk">
        Kliknij **"Zapisz"** - quiz jest gotowy do uruchomienia!
      </Step>
    </Steps>
  </Tab>

  <Tab title="Generowanie z AI" icon="robot">
    <Steps>
      <Step title="Otwórz generator AI" icon="wand-magic-sparkles">
        W panelu "Moje quizy" kliknij **"Generuj z AI"** (ikona robota).
      </Step>

      <Step title="Opisz temat" icon="keyboard">
        Wpisz szczegółowy temat, np.:

        * "Stolice krajów europejskich"
        * "Podstawy programowania w Python"
        * "Historia II wojny światowej w Europie"
      </Step>

      <Step title="Skonfiguruj parametry" icon="sliders">
        | Parametr             | Opcje                                  |
        | -------------------- | -------------------------------------- |
        | **Liczba pytań**     | 5-30                                   |
        | **Język**            | Polski, English, Español, Deutsch, 한국어 |
        | **Poziom trudności** | Łatwy, Średni, Trudny                  |
        | **Typy pytań**       | Wybierz które uwzględnić               |
      </Step>

      <Step title="Generuj i sprawdź" icon="sparkles">
        1. Kliknij **"Generuj quiz"**
        2. Poczekaj na przetworzenie (zwykle 10-30s)
        3. **Zawsze przejrzyj** wygenerowane pytania
        4. Edytuj jeśli potrzeba
        5. Zapisz quiz
      </Step>
    </Steps>

    <Warning>
      **Weryfikuj treści AI**: Generowane pytania mogą zawierać błędy. Zawsze sprawdź poprawność przed użyciem quizu.
    </Warning>
  </Tab>
</Tabs>

***

## Uruchomienie sesji

<Steps>
  <Step title="Wybierz quiz" icon="play">
    W panelu "Moje quizy" znajdź quiz i kliknij **"Uruchom"** (zielony przycisk).
  </Step>

  <Step title="Skonfiguruj sesję" icon="gear">
    <AccordionGroup>
      <Accordion title="Tryb punktacji" icon="trophy">
        | Tryb            | Opis                            |
        | --------------- | ------------------------------- |
        | **Standard**    | Punkty za poprawność + szybkość |
        | **Dokładność**  | Punkty karne za błędy           |
        | **Seria**       | Bonusy za serie poprawnych      |
        | **Przetrwanie** | Eliminacja po N błędach         |
      </Accordion>

      <Accordion title="Dodatkowe opcje" icon="toggle-on">
        * **Losowa kolejność odpowiedzi** - utrudnia ściąganie
        * **Tryb drużynowy** - rywalizacja zespołów
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Udostępnij kod" icon="share-nodes">
    Na ekranie lobby zobaczysz:

    <CardGroup cols={3}>
      <Card title="Kod PIN" icon="hashtag">
        6-cyfrowy kod do wpisania ręcznie
      </Card>

      <Card title="Kod QR" icon="qrcode">
        Do zeskanowania telefonem
      </Card>

      <Card title="Link" icon="link">
        Do udostępnienia bezpośrednio
      </Card>
    </CardGroup>
  </Step>

  <Step title="Poczekaj na uczestników" icon="users">
    Uczestnicy pojawiają się na liście w lobby. Gdy wszyscy są gotowi...
  </Step>

  <Step title="Rozpocznij quiz" icon="rocket">
    Kliknij **"Start"** - quiz się rozpoczyna!
  </Step>
</Steps>

***

## Prowadzenie quizu

<Info>
  Podczas sesji masz pełną kontrolę nad przepływem quizu.
</Info>

| Akcja                | Ikona                        | Opis                              |
| -------------------- | ---------------------------- | --------------------------------- |
| **Następne pytanie** | <Icon icon="forward" />      | Przejście do kolejnego pytania    |
| **Pokaż wyniki**     | <Icon icon="chart-bar" />    | Wyświetlenie poprawnej odpowiedzi |
| **Ranking**          | <Icon icon="ranking-star" /> | Podgląd aktualnego rankingu       |
| **Pauza**            | <Icon icon="pause" />        | Wstrzymanie timera                |

<Tip>
  **Remote Pilot**: Steruj quizem z telefonu! W lobby kliknij ikonę pilota i zeskanuj QR swoim smartfonem.
</Tip>

***

## Po zakończeniu

<Steps>
  <Step title="Przejrzyj wyniki" icon="medal">
    Po ostatnim pytaniu zobaczysz:

    * <Icon icon="trophy" /> Podium (top 3)
    * <Icon icon="list-ol" /> Pełny ranking
    * <Icon icon="chart-pie" /> Statystyki per pytanie
  </Step>

  <Step title="Eksportuj raport" icon="download">
    Kliknij **"Eksportuj"** i wybierz format:

    <CardGroup cols={3}>
      <Card title="PDF" icon="file-pdf">
        Raport do druku
      </Card>

      <Card title="Excel" icon="file-excel">
        Szczegółowe dane
      </Card>

      <Card title="JSON" icon="file-code">
        Do dalszej analizy
      </Card>
    </CardGroup>
  </Step>
</Steps>

***

## Co dalej?

<CardGroup cols={2}>
  <Card title="Typy pytań" icon="circle-question" color="#5144C7" href="/pl/pytania/przeglad">
    Poznaj wszystkie 9 typów pytań i ich zastosowania
  </Card>

  <Card title="Tryby gry" icon="trophy" color="#E5BD55" href="/pl/tryby/przeglad">
    Wybierz najlepszy tryb punktacji dla Twojego quizu
  </Card>

  <Card title="Generowanie AI" icon="robot" color="#5144C7" href="/pl/ai/generator">
    Twórz quizy automatycznie z tematu lub dokumentu
  </Card>

  <Card title="Import quizów" icon="file-import" color="#E5BD55" href="/pl/quizy/import-eksport">
    Importuj quizy z Excel lub JSON
  </Card>
</CardGroup>