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

# Flashcard study flow

> Understand the current BlueAccademy flashcard review loop.

Every flashcard session follows the same core loop: load due cards, flip a card, rate recall, then move to the next scheduled item.

## Step-by-step session walkthrough

<Steps>
  <Step title="Select a deck">
    Open a deck from the flashcards list.
  </Step>

  <Step title="The card queue loads">
    The backend builds the queue from cards due in that deck:

    * **Blue border** — New card (never studied before)
    * **Red border** — Learning or Relearning card (progressing through learning or relearning steps)
    * **Green border** — Due card (returning for a long-term review)
  </Step>

  <Step title="Read the question and flip the card">
    Read the front of the card, then flip to reveal the answer. If the card includes a code example, it is shown with the answer.
  </Step>

  <Step title="Rate your recall">
    Choose the rating that best matches your recall:

    | Button       | When to use it                                 |
    | ------------ | ---------------------------------------------- |
    | **Blackout** | You drew a complete blank                      |
    | **Hard**     | You remembered, but it took significant effort |
    | **Good**     | Correct recall with normal effort              |
    | **Easy**     | Instant, effortless recall                     |
  </Step>

  <Step title="The scheduler updates and loads the next card">
    The backend records the rating, updates progress, calculates the next interval, and advances the queue.
  </Step>

  <Step title="Session ends when the queue is empty">
    When there are no more due cards in that queue, the session ends.
  </Step>
</Steps>

## Undoing the last review

If you rate a card by mistake, you can undo the most recent review.

* **Keyboard shortcut:** Press `Cmd+Z` on macOS or `Ctrl+Z` on Windows and Linux.

Undo restores the previous progress state for that card. Only the latest review is undoable.

## Practical edge case

If you see "all caught up" immediately, do not assume the deck is empty. More common causes are:

* No cards are due yet
* Your new-card limit has already been reached
* The seed step has not populated the database as expected