> ## 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.

# Flashcards overview

> Understand the current supported flashcard workflow and backend model.

The flashcard system is the stable, supported slice of BlueAccademy today.

It gives you a structured way to work with decks, cards, review history, and scheduler-backed intervals. Starter content is seeded from the repository, and you can extend it with your own decks and cards.

## How it works

At a high level:

1. Decks group related cards.
2. The backend determines which cards are due.
3. You flip a card and rate recall.
4. The scheduler writes the new progress state and next interval.

The implementation is currently backed by the Python/FastAPI backend in `backend/app/services/flashcards/`.

## Card states

Cards move through four scheduler states:

| State       | Meaning                                                    |
| ----------- | ---------------------------------------------------------- |
| **New**     | Card has not been reviewed yet.                            |
| **Learn**   | Card is moving through initial learning steps.             |
| **Relearn** | Card was forgotten from review and is being learned again. |
| **Review**  | Card has graduated to longer-term spaced repetition.       |

## Rating scale

After you flip a card, you choose one of four ratings:

| Rating       | Value | What it means                                             | Effect on interval                                                                          |
| ------------ | ----- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Blackout** | 0     | Complete blank — you could not recall anything            | Card enters (or re-enters) relearning from the first step                                   |
| **Hard**     | 1     | Difficult recall — you remembered with significant effort | Interval is shortened compared to a Good rating                                             |
| **Good**     | 2     | Correct with effort — the expected result                 | Card advances to the next learning step, or the interval grows at the standard rate         |
| **Easy**     | 3     | Instant recall — no hesitation at all                     | Card jumps ahead to your configured easy review interval, skipping remaining learning steps |

## Seeded content

Starter content is seeded from the main product repo:

* `backend/app/db/learning_content/decks.json`
* `backend/app/db/learning_content/cards.json`

Other learning-content files exist in the repo for in-progress areas, but only the current flashcard slice should be treated as supported.

## Boundaries

Do not read this section as a promise about the rest of the platform.

* Flashcards are supported now.
* Guided terminal exercises are in progress.
* CKAD simulations, end-to-end labs, chat, and hosted sandboxes are not yet supported.

## Where to go next

<CardGroup cols={2}>
  <Card title="Study Flow" icon="play" href="/flashcards/study-flow">
    Walk through the supported review loop and the main session behaviors.
  </Card>

  <Card title="Decks" icon="layer-group" href="/flashcards/decks">
    Learn how seeded decks, custom decks, track tags, and deck operations work.
  </Card>

  <Card title="Custom Cards" icon="pen-to-square" href="/flashcards/custom-cards">
    Add or edit cards without changing the overall runtime assumptions.
  </Card>

  <Card title="Anki Import" icon="file-import" href="/flashcards/anki-import">
    Import plain-text Anki exports into the current flashcard system.
  </Card>

  <Card title="Settings" icon="gear" href="/flashcards/settings">
    Adjust the scheduler pacing and default intervals.
  </Card>
</CardGroup>