# sergey-bukreev/flash-cards architecture

> Architecture diagram of the GitHub repository sergey-bukreev/flash-cards, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sergey-bukreev/flash-cards
- Repository: https://github.com/sergey-bukreev/flash-cards

## Overview

Flashcards Live is a React flashcard application for account access, deck and card management, studying cards, and profile editing. The principal workflow is: a signed-in learner browses decks, opens a deck’s cards, studies a random card, reveals its answer, and submits a rating. Deck and card management and account/profile operations are separate branches. The graph connects only relationships supported by the README or shown in the supplied source index and excerpts; some page-to-service links are supported by index references rather than inspected page code.

Main entry points: [`src/router.tsx`](https://github.com/sergey-bukreev/flash-cards/blob/main/src/router.tsx) (Route access), [`src/services/auth/auth.service.ts`](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/auth/auth.service.ts) (Authentication), [`src/pages/learn/learn.page.tsx`](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/learn/learn.page.tsx) (Study session), [`src/services/decks/decks.sevice.ts`](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/decks/decks.sevice.ts) (Deck operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application routing"]
  node_entry["React entry<br/>[main.tsx]"]
  node_app_root["App root<br/>[App.tsx]"]
  node_router["Route access<br/>[router.tsx]"]
  node_layout["Application layout<br/>[layout.tsx]"]
end

subgraph group_accounts["Accounts and profile"]
  node_auth_pages["Sign-in and signup<br/>[sign-in.page.tsx]"]
  node_profile["Profile editing<br/>[profile.tsx]"]
  node_profile_hook["Profile state"]
  node_recover["Password recovery<br/>[email-recover.tsx]"]
end

subgraph group_decks["Deck and card management"]
  node_deck_list["Deck browsing<br/>[decks.page.tsx]"]
  node_deck_list_logic["Deck list state<br/>[use-decks-page.tsx]"]
  node_deck_detail["Deck and cards<br/>[deck.page.tsx]"]
  node_deck_logic["Deck page state<br/>[use-deck.page.ts]"]
end

subgraph group_study["Card learning"]
  node_learn["Study session<br/>[learn.page.tsx]"]
  node_rate_form["Card rating form<br/>[rate-card-form.tsx]"]
end

subgraph group_services["API services"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_deck_service["Deck operations<br/>[decks.sevice.ts]"]
  node_card_service["Card operations<br/>[card.service.ts]"]
  node_api["API configuration<br/>[flashcards-api.ts]"]
  node_base_query["HTTP base query"]
end

node_learner(("Learner"))
node_backend[("Flashcards API")]

node_learner -.->|"opens app"| node_entry
node_entry -->|"renders"| node_app_root
node_app_root -->|"renders"| node_router
node_router -->|"wraps routes"| node_layout
node_router -->|"routes to"| node_auth_pages
node_router -->|"routes to"| node_deck_list
node_router -->|"routes to"| node_deck_detail
node_router -->|"routes to"| node_learn
node_router -->|"routes to"| node_profile
node_layout -->|"checks identity"| node_auth_service
node_auth_pages -->|"authenticates"| node_auth_service
node_profile -->|"uses state"| node_profile_hook
node_profile_hook -.->|"updates account"| node_auth_service
node_recover -.->|"recovers account"| node_auth_service
node_deck_list -.->|"uses state"| node_deck_list_logic
node_deck_list_logic -->|"loads decks"| node_deck_service
node_deck_detail -.->|"uses state"| node_deck_logic
node_deck_logic -->|"loads deck"| node_deck_service
node_deck_logic -->|"loads cards"| node_card_service
node_learn -->|"loads deck"| node_deck_service
node_learn -->|"studies and rates"| node_card_service
node_learn -->|"renders"| node_rate_form
node_auth_service -->|"injects endpoints"| node_api
node_deck_service -->|"injects endpoints"| node_api
node_card_service -->|"injects endpoints"| node_api
node_api -->|"configures query"| node_base_query
node_base_query -.->|"sends requests"| node_backend

click node_entry "https://github.com/sergey-bukreev/flash-cards/blob/main/src/main.tsx"
click node_app_root "https://github.com/sergey-bukreev/flash-cards/blob/main/src/App.tsx"
click node_router "https://github.com/sergey-bukreev/flash-cards/blob/main/src/router.tsx"
click node_layout "https://github.com/sergey-bukreev/flash-cards/blob/main/src/components/layout/layout.tsx"
click node_auth_pages "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/sign-in/sign-in.page.tsx"
click node_auth_service "https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/auth/auth.service.ts"
click node_profile "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/profile/profile.tsx"
click node_profile_hook "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/profile/use-profile-page.ts"
click node_recover "https://github.com/sergey-bukreev/flash-cards/blob/main/src/components/common/utils/email-recover.tsx"
click node_deck_list "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/decks/decks.page.tsx"
click node_deck_list_logic "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/decks/use-decks-page.tsx"
click node_deck_detail "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/deck/deck.page.tsx"
click node_deck_logic "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/deck/use-deck.page.ts"
click node_deck_service "https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/decks/decks.sevice.ts"
click node_card_service "https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/cards/card.service.ts"
click node_learn "https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/learn/learn.page.tsx"
click node_rate_form "https://github.com/sergey-bukreev/flash-cards/blob/main/src/components/forms/rate-card-form/rate-card-form.tsx"
click node_api "https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/flashcards-api.ts"
click node_base_query "https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/flashcards-base-query.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_app_root,node_router,node_layout toneBlue
class node_auth_pages,node_profile,node_profile_hook,node_recover,node_backend toneAmber
class node_deck_list,node_deck_list_logic,node_deck_detail,node_deck_logic toneMint
class node_learn,node_rate_form toneRose
class node_auth_service,node_deck_service,node_card_service,node_api,node_base_query,node_learner toneIndigo
```

## Components

### Application routing

- [React entry](https://github.com/sergey-bukreev/flash-cards/blob/main/src/main.tsx): `src/main.tsx`
- [App root](https://github.com/sergey-bukreev/flash-cards/blob/main/src/App.tsx): `src/App.tsx`
- [Route access](https://github.com/sergey-bukreev/flash-cards/blob/main/src/router.tsx): `src/router.tsx`
- [Application layout](https://github.com/sergey-bukreev/flash-cards/blob/main/src/components/layout/layout.tsx): `src/components/layout/layout.tsx`

### Accounts and profile

- [Sign-in and signup](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/sign-in/sign-in.page.tsx): `src/pages/sign-in/sign-in.page.tsx`
- [Profile editing](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/profile/profile.tsx): `src/pages/profile/profile.tsx`
- [Profile state](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/profile/use-profile-page.ts): `src/pages/profile/use-profile-page.ts`
- [Password recovery](https://github.com/sergey-bukreev/flash-cards/blob/main/src/components/common/utils/email-recover.tsx): `src/components/common/utils/email-recover.tsx`

### Deck and card management

- [Deck browsing](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/decks/decks.page.tsx): `src/pages/decks/decks.page.tsx`
- [Deck list state](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/decks/use-decks-page.tsx): `src/pages/decks/use-decks-page.tsx`
- [Deck and cards](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/deck/deck.page.tsx): `src/pages/deck/deck.page.tsx`
- [Deck page state](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/deck/use-deck.page.ts): `src/pages/deck/use-deck.page.ts`

### Card learning

- [Study session](https://github.com/sergey-bukreev/flash-cards/blob/main/src/pages/learn/learn.page.tsx): `src/pages/learn/learn.page.tsx`
- [Card rating form](https://github.com/sergey-bukreev/flash-cards/blob/main/src/components/forms/rate-card-form/rate-card-form.tsx): `src/components/forms/rate-card-form/rate-card-form.tsx`

### API services

- [Authentication](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/auth/auth.service.ts): `src/services/auth/auth.service.ts`
- [Deck operations](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/decks/decks.sevice.ts): `src/services/decks/decks.sevice.ts`
- [Card operations](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/cards/card.service.ts): `src/services/cards/card.service.ts`
- [API configuration](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/flashcards-api.ts): `src/services/flashcards-api.ts`
- [HTTP base query](https://github.com/sergey-bukreev/flash-cards/blob/main/src/services/flashcards-base-query.ts): `src/services/flashcards-base-query.ts`

### Other components

- **Learner**
- **Flashcards API**

## Connections

- Learner → React entry: opens app
- React entry → App root: renders (evidence: `src/main.tsx`)
- App root → Route access: renders (evidence: `src/App.tsx`)
- Route access → Application layout: wraps routes (evidence: `src/router.tsx`)
- Route access → Sign-in and signup: routes to (evidence: `src/router.tsx`)
- Route access → Deck browsing: routes to (evidence: `src/router.tsx`)
- Route access → Deck and cards: routes to (evidence: `src/router.tsx`)
- Route access → Study session: routes to (evidence: `src/router.tsx`)
- Route access → Profile editing: routes to (evidence: `src/router.tsx`)
- Application layout → Authentication: checks identity (evidence: `src/components/layout/layout.tsx`)
- Sign-in and signup → Authentication: authenticates (evidence: `src/pages/sign-in/sign-in.page.tsx`)
- Profile editing → Profile state: uses state (evidence: `src/pages/profile/profile.tsx`)
- Profile state → Authentication: updates account
- Password recovery → Authentication: recovers account
- Deck browsing → Deck list state: uses state
- Deck list state → Deck operations: loads decks (evidence: `src/pages/decks/use-decks-page.tsx`)
- Deck and cards → Deck page state: uses state
- Deck page state → Deck operations: loads deck (evidence: `src/pages/deck/use-deck.page.ts`)
- Deck page state → Card operations: loads cards (evidence: `src/pages/deck/use-deck.page.ts`)
- Study session → Deck operations: loads deck (evidence: `src/pages/learn/learn.page.tsx`)
- Study session → Card operations: studies and rates (evidence: `src/pages/learn/learn.page.tsx`)
- Study session → Card rating form: renders (evidence: `src/pages/learn/learn.page.tsx`)
- Authentication → API configuration: injects endpoints (evidence: `src/services/auth/auth.service.ts`)
- Deck operations → API configuration: injects endpoints (evidence: `src/services/decks/decks.sevice.ts`)
- Card operations → API configuration: injects endpoints (evidence: `src/services/cards/card.service.ts`)
- API configuration → HTTP base query: configures query (evidence: `src/services/flashcards-api.ts`)
- HTTP base query → Flashcards API: sends requests
