# aamrits/digital-store architecture

> Architecture diagram of the GitHub repository aamrits/digital-store, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aamrits/digital-store
- Repository: https://github.com/aamrits/digital-store

## Overview

This is a small Astro digital-bookstore site: visitors can discover book listings and details, then open a PDF in an interactive reader. The reader supports page navigation, table of contents, zoom, fullscreen, keyboard controls, and responsive page-flip rendering. The repository also contains about, contact, account, and library routes, but their behavior and wiring were not sampled. Those route relationships are therefore shown only as unverified; the demonstrated reader component relationships are sourced from excerpts.

Main entry points: [`src/components/react/BookReader.tsx`](https://github.com/aamrits/digital-store/blob/main/src/components/react/BookReader.tsx) (Reader controller), [`src/data/books.ts`](https://github.com/aamrits/digital-store/blob/main/src/data/books.ts) (Book catalog data), [`src/components/react/BookViewport.tsx`](https://github.com/aamrits/digital-store/blob/main/src/components/react/BookViewport.tsx) (Page-flip viewport), [`src/pages/books/index.astro`](https://github.com/aamrits/digital-store/blob/main/src/pages/books/index.astro) (Book listings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Book catalog"]
  node_home["Home page<br/>[index.astro]"]
  node_listing["Book listings<br/>[index.astro]"]
  node_details["Book details<br/>[&#91;slug&#93;.astro]"]
end

subgraph group_reading["PDF reading"]
  node_read_route["Reader route<br/>[&#91;slug&#93;.astro]"]
  node_reader["Reader controller<br/>[BookReader.tsx]"]
  node_toolbar["Reader toolbar<br/>[ReaderToolbar.tsx]"]
  node_sidebar["Contents sidebar<br/>[ReaderSidebar.tsx]"]
  node_viewport["Page-flip viewport<br/>[BookViewport.tsx]"]
  node_reader_layout["Reader layout<br/>[ReaderLayout.astro]"]
end

subgraph group_site["Site pages"]
  node_about["About page<br/>[about.astro]"]
  node_contact["Contact page<br/>[contact.astro]"]
  node_account["Account page<br/>[account.astro]"]
  node_library["Library page<br/>[library.astro]"]
  node_main_layout["Main site layout<br/>[MainLayout.astro]"]
end

subgraph group_content["Book content"]
  node_book_data["Book catalog data<br/>[books.ts]"]
  node_book_types["Book data types<br/>[book.ts]"]
  node_pdf_files["Book PDFs"]
end

node_visitor(("Visitor"))
node_pdfjs["PDF.js"]
node_pageflip["Page-flip library"]

node_visitor -.->|"opens"| node_home
node_visitor -.->|"browses"| node_listing
node_visitor -.->|"views"| node_details
node_visitor -.->|"opens"| node_read_route
node_visitor -.->|"opens"| node_about
node_visitor -.->|"opens"| node_contact
node_visitor -.->|"opens"| node_account
node_visitor -.->|"opens"| node_library
node_read_route -.->|"renders"| node_reader
node_reader -->|"renders"| node_toolbar
node_reader -->|"renders"| node_sidebar
node_reader -->|"renders"| node_viewport
node_reader -->|"loads PDF with"| node_pdfjs
node_viewport -->|"renders pages with"| node_pdfjs
node_viewport -->|"uses"| node_pageflip
node_book_data -->|"uses types"| node_book_types
node_details -.->|"uses catalog"| node_book_data
node_listing -.->|"uses catalog"| node_book_data
node_book_data -->|"references PDF paths"| node_pdf_files
node_reader -->|"uses type"| node_book_types

click node_home "https://github.com/aamrits/digital-store/blob/main/src/pages/index.astro"
click node_listing "https://github.com/aamrits/digital-store/blob/main/src/pages/books/index.astro"
click node_details "https://github.com/aamrits/digital-store/blob/main/src/pages/books/%5Bslug%5D.astro"
click node_book_data "https://github.com/aamrits/digital-store/blob/main/src/data/books.ts"
click node_book_types "https://github.com/aamrits/digital-store/blob/main/src/types/book.ts"
click node_pdf_files "https://github.com/aamrits/digital-store/tree/main/public/books"
click node_read_route "https://github.com/aamrits/digital-store/blob/main/src/pages/read/%5Bslug%5D.astro"
click node_reader "https://github.com/aamrits/digital-store/blob/main/src/components/react/BookReader.tsx"
click node_toolbar "https://github.com/aamrits/digital-store/blob/main/src/components/react/ReaderToolbar.tsx"
click node_sidebar "https://github.com/aamrits/digital-store/blob/main/src/components/react/ReaderSidebar.tsx"
click node_viewport "https://github.com/aamrits/digital-store/blob/main/src/components/react/BookViewport.tsx"
click node_about "https://github.com/aamrits/digital-store/blob/main/src/pages/about.astro"
click node_contact "https://github.com/aamrits/digital-store/blob/main/src/pages/contact.astro"
click node_account "https://github.com/aamrits/digital-store/blob/main/src/pages/account.astro"
click node_library "https://github.com/aamrits/digital-store/blob/main/src/pages/library.astro"
click node_main_layout "https://github.com/aamrits/digital-store/blob/main/src/layouts/MainLayout.astro"
click node_reader_layout "https://github.com/aamrits/digital-store/blob/main/src/layouts/ReaderLayout.astro"

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_home,node_listing,node_details toneBlue
class node_read_route,node_reader,node_toolbar,node_sidebar,node_viewport,node_reader_layout toneAmber
class node_about,node_contact,node_account,node_library,node_main_layout toneMint
class node_book_data,node_book_types,node_pdf_files toneRose
class node_visitor,node_pdfjs,node_pageflip toneIndigo
```

## Components

### Book catalog

- [Home page](https://github.com/aamrits/digital-store/blob/main/src/pages/index.astro): `src/pages/index.astro`
- [Book listings](https://github.com/aamrits/digital-store/blob/main/src/pages/books/index.astro): `src/pages/books/index.astro`
- [Book details](https://github.com/aamrits/digital-store/blob/main/src/pages/books/%5Bslug%5D.astro): `src/pages/books/[slug].astro`

### PDF reading

- [Reader route](https://github.com/aamrits/digital-store/blob/main/src/pages/read/%5Bslug%5D.astro): `src/pages/read/[slug].astro`
- [Reader controller](https://github.com/aamrits/digital-store/blob/main/src/components/react/BookReader.tsx): `src/components/react/BookReader.tsx`
- [Reader toolbar](https://github.com/aamrits/digital-store/blob/main/src/components/react/ReaderToolbar.tsx): `src/components/react/ReaderToolbar.tsx`
- [Contents sidebar](https://github.com/aamrits/digital-store/blob/main/src/components/react/ReaderSidebar.tsx): `src/components/react/ReaderSidebar.tsx`
- [Page-flip viewport](https://github.com/aamrits/digital-store/blob/main/src/components/react/BookViewport.tsx): `src/components/react/BookViewport.tsx`
- [Reader layout](https://github.com/aamrits/digital-store/blob/main/src/layouts/ReaderLayout.astro): `src/layouts/ReaderLayout.astro`

### Site pages

- [About page](https://github.com/aamrits/digital-store/blob/main/src/pages/about.astro): `src/pages/about.astro`
- [Contact page](https://github.com/aamrits/digital-store/blob/main/src/pages/contact.astro): `src/pages/contact.astro`
- [Account page](https://github.com/aamrits/digital-store/blob/main/src/pages/account.astro): `src/pages/account.astro`
- [Library page](https://github.com/aamrits/digital-store/blob/main/src/pages/library.astro): `src/pages/library.astro`
- [Main site layout](https://github.com/aamrits/digital-store/blob/main/src/layouts/MainLayout.astro): `src/layouts/MainLayout.astro`

### Book content

- [Book catalog data](https://github.com/aamrits/digital-store/blob/main/src/data/books.ts): `src/data/books.ts`
- [Book data types](https://github.com/aamrits/digital-store/blob/main/src/types/book.ts): `src/types/book.ts`
- [Book PDFs](https://github.com/aamrits/digital-store/tree/main/public/books): `public/books`

### Other components

- **Visitor**
- **PDF.js**
- **Page-flip library**

## Connections

- Visitor → Home page: opens
- Visitor → Book listings: browses
- Visitor → Book details: views
- Visitor → Reader route: opens
- Visitor → About page: opens
- Visitor → Contact page: opens
- Visitor → Account page: opens
- Visitor → Library page: opens
- Reader route → Reader controller: renders
- Reader controller → Reader toolbar: renders (evidence: `src/components/react/BookReader.tsx`)
- Reader controller → Contents sidebar: renders (evidence: `src/components/react/BookReader.tsx`)
- Reader controller → Page-flip viewport: renders (evidence: `src/components/react/BookReader.tsx`)
- Reader controller → PDF.js: loads PDF with (evidence: `src/components/react/BookReader.tsx`)
- Page-flip viewport → PDF.js: renders pages with (evidence: `src/components/react/BookViewport.tsx`)
- Page-flip viewport → Page-flip library: uses (evidence: `src/components/react/BookViewport.tsx`)
- Book catalog data → Book data types: uses types (evidence: `src/data/books.ts`)
- Book details → Book catalog data: uses catalog
- Book listings → Book catalog data: uses catalog
- Book catalog data → Book PDFs: references PDF paths (evidence: `src/data/books.ts`)
- Reader controller → Book data types: uses type (evidence: `src/components/react/BookReader.tsx`)
