> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/crizmo/KWordle/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get started playing KWordle in minutes - your first game guide

## Your first game

Once you've [installed KWordle](/installation), you're ready to play! Here's how to start guessing your first word.

## The game interface

When you open KWordle, you'll see:

* A **6×5 letter grid** where your guesses appear
* An **on-screen keyboard** for touch input
* **Control buttons** at the bottom (New Game, Language, Stats, Credits)

<Steps>
  <Step title="Make your first guess">
    Start by typing a 5-letter word using either:

    * Your Kindle's **physical keyboard** (if available)
    * The **on-screen keyboard** by tapping letters

    Each letter you type appears in the current row of the grid.
  </Step>

  <Step title="Submit your guess">
    Once you've entered all 5 letters, press:

    * **Enter** on the physical keyboard, or
    * The **✓** button on the on-screen keyboard

    The game will check if your word is valid. If it's not in the word list, you'll see an error message.
  </Step>

  <Step title="Read the feedback">
    After submitting, each letter shows an indicator:

    | Indicator         | Meaning                                     |
    | ----------------- | ------------------------------------------- |
    | ■ (filled square) | Letter is correct and in the right position |
    | □ (empty square)  | Letter is in the word but wrong position    |
    | × (cross)         | Letter is not in the word at all            |

    Use this feedback to make your next guess!
  </Step>

  <Step title="Keep guessing">
    You have 6 total attempts to guess the word. Each guess should use the information from previous attempts to get closer to the answer.
  </Step>
</Steps>

## How the game checks your guess

KWordle uses a two-pass algorithm to check your guesses:

```javascript theme={null}
// From main.js:243-275
// First pass: Mark exact matches (correct position)
for (var i = 0; i < guess.length; i++) {
  if (guess[i] === targetWord[i]) {
    currentRow[i].state = states.correct;
    letterCounts[guess[i]]--;
  }
}

// Second pass: Mark present letters (wrong position)
for (var i = 0; i < guess.length; i++) {
  if (currentRow[i].state !== states.correct) {
    if (letterCounts[guess[i]] > 0) {
      currentRow[i].state = states.present;
      letterCounts[guess[i]]--;
    } else {
      currentRow[i].state = states.absent;
    }
  }
}
```

This ensures letters are marked correctly even when the target word has duplicate letters.

## Example game

Let's say the target word is **CRANE**. Here's how a game might progress:

| Attempt | Word  | Feedback           | What you learn                                     |
| ------- | ----- | ------------------ | -------------------------------------------------- |
| 1       | STARE | S×, T×, A□, R□, E□ | A, R, E are in the word but wrong positions        |
| 2       | TRACE | T×, R□, A□, C■, E■ | C and E are correct! R and A still wrong positions |
| 3       | CRANE | C■, R■, A■, N■, E■ | You win! All letters correct                       |

## Input methods

<Tabs>
  <Tab title="On-screen keyboard">
    The on-screen keyboard has three rows:

    ```text theme={null}
    Q W E R T Y U I O P
     A S D F G H J K L
      Z X C V B N M ✓ ←
    ```

    * Tap letters to add them to your guess
    * Tap **✓** (checkmark) to submit your guess
    * Tap **←** (backspace) to delete the last letter

    <Tip>The keyboard buttons have extra spacing to make them easier to tap on Kindle's e-ink touchscreen.</Tip>
  </Tab>

  <Tab title="Physical keyboard">
    If your Kindle has a physical keyboard:

    * Type **A-Z** to enter letters
    * Press **Enter** to submit your guess
    * Press **Backspace** to delete the last letter

    ```javascript theme={null}
    // From main.js:567-586
    document.addEventListener("keydown", function(event) {
      if (gameState.gameOver) return;
      
      var key = event.key.toUpperCase();
      
      if (key === "ENTER") {
        submitGuess();
      } else if (key === "BACKSPACE") {
        deleteLetter();
      } else if (key.length === 1 && key >= "A" && key <= "Z") {
        addLetter(key);
      }
    });
    ```
  </Tab>
</Tabs>

## Supported languages

KWordle supports 8 languages! Tap the **Language** button to switch:

<CardGroup cols={4}>
  <Card title="English" icon="flag-usa">
    2,315 words
  </Card>

  <Card title="French" icon="flag">
    1,476 words
  </Card>

  <Card title="German" icon="flag">
    3,234 words
  </Card>

  <Card title="Spanish" icon="flag">
    2,683 words
  </Card>

  <Card title="Portuguese" icon="flag">
    2,518 words
  </Card>

  <Card title="Swedish" icon="flag">
    2,089 words
  </Card>

  <Card title="Italian" icon="flag">
    1,897 words
  </Card>

  <Card title="Latin" icon="book">
    1,234 words
  </Card>
</CardGroup>

<Note>
  For more details on language support, see the [Languages](/languages) page.
</Note>

## Tracking your progress

KWordle automatically saves your game statistics including:

* Games played
* Win percentage
* Current win streak
* Longest win streak
* Guess distribution

Tap the **Stats** button anytime to see your progress!

```json theme={null}
{
  "gamesPlayed": 0,
  "gamesWon": 0,
  "currentStreak": 0,
  "maxStreak": 0,
  "guessDistribution": [0, 0, 0, 0, 0, 0]
}
```

## Tips for success

<AccordionGroup>
  <Accordion title="Start with common letters" icon="lightbulb">
    Use words with common vowels (A, E, I, O, U) and consonants (R, S, T, L, N) in your first guesses to maximize information.
  </Accordion>

  <Accordion title="Use all the feedback" icon="magnifying-glass">
    Pay attention to both correct positions (■) and wrong positions (□). A letter marked with □ means you need to move it to a different position.
  </Accordion>

  <Accordion title="Eliminate letters" icon="circle-xmark">
    Letters marked with × are not in the word at all. Don't use them in future guesses.
  </Accordion>

  <Accordion title="Consider letter frequency" icon="chart-bar">
    Some letters appear more often in 5-letter words. The most common are: E, A, R, O, T, L, I, S, N.
  </Accordion>

  <Accordion title="Take your time" icon="clock">
    There's no time limit! Think carefully about each guess to use your 6 attempts wisely.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Learn gameplay details" icon="gamepad" href="/gameplay">
    Understand the complete rules and scoring system
  </Card>

  <Card title="Switch languages" icon="language" href="/languages">
    Play in French, German, Spanish, and more
  </Card>

  <Card title="View statistics" icon="chart-line" href="/statistics">
    Track your performance and improve your skills
  </Card>

  <Card title="Explore controls" icon="keyboard" href="/controls">
    Master all input methods and keyboard shortcuts
  </Card>
</CardGroup>