# User guide

This guide is for people **using** a Takhtabush instance: signing in, building
decks, studying, and reading progress.

> Self-hosting or contributing? Start with the [developer guide](../developer/README.md).

## Start here

| I want to…                                | Read                                   |
| ----------------------------------------- | -------------------------------------- |
| Sign in and make my first deck            | [Getting started](getting-started.md)  |
| Understand the card types and Markdown    | [Decks and cards](decks-and-cards.md)  |
| Study with a mode, goal, and timer        | [Studying](studying.md)                |
| Read accuracy, due counts, and weak cards | [Progress](progress.md)                |
| Move cards in and out                     | [Import and export](import-export.md)  |
| Manage sign-in, sessions, and theme       | [Account and sessions](account.md)     |
| Connect ChatGPT, Claude, or Codex         | [Use an AI assistant](ai-assistant.md) |
| Get a quick answer                        | [FAQ](faq.md)                          |

## The five-minute version

1. Sign in with your email; open the link you receive.
2. Choose **New deck**, name it, and save.
3. Open the deck and choose **Add card**.
4. Pick a card type, write the front and back, and save.
5. Choose **Study**, pick a mode and a time limit, and start.

Your dashboard shows decks, total cards, and any sessions you paused. The
statistics page shows what is due and which cards are giving you trouble.