# ruhanazevedo/free-exercise-db architecture

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

- Interactive diagram: https://gitdiagram.com/ruhanazevedo/free-exercise-db
- Repository: https://github.com/ruhanazevedo/free-exercise-db

## Overview

Free Exercise DB is a public-domain exercise dataset with a Vue browsing frontend. Users search or browse the exercise records, inspect instructions and photos, and bookmark exercises for later. The dataset is organized as individual JSON records and images; the frontend also imports the combined dataset. Source excerpts show the UI wiring and browser-local bookmark persistence. The README documents dataset formats and capabilities; unsampled data-generation details are not mapped.

Main entry points: [`site/src/components/SearchBar.vue`](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/SearchBar.vue) (Search and bookmarks), [`site/src/components/PhotoGallery.vue`](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/PhotoGallery.vue) (Photo gallery), [`site/src/App.vue`](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/App.vue) (App shell), [`exercises`](https://github.com/ruhanazevedo/free-exercise-db/tree/main/exercises) (Exercise images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Exercise content"]
  node_records["Exercise records"]
  node_combined["Combined dataset<br/>[exercises.json]"]
  node_images["Exercise images"]
end

subgraph group_frontend["Browse frontend"]
  node_app["App shell<br/>[App.vue]"]
  node_search["Search and bookmarks<br/>[SearchBar.vue]"]
  node_saved[("Saved exercises")]
end

subgraph group_presentation["Exercise presentation"]
  node_instructions["Instructions view"]
  node_gallery["Photo gallery<br/>[PhotoGallery.vue]"]
end

node_visitor(("Visitor"))
node_imagekit["ImageKit"]

node_visitor -->|"opens frontend"| node_app
node_app -->|"renders"| node_search
node_search -->|"loads records"| node_combined
node_records -->|"references images"| node_images
node_search -->|"shows results"| node_visitor
node_search -->|"renders"| node_instructions
node_search -->|"renders"| node_gallery
node_search -->|"reads and writes"| node_saved
node_gallery -->|"requests resized photos"| node_imagekit
node_gallery -->|"selects photo paths"| node_images

click node_records "https://github.com/ruhanazevedo/free-exercise-db/tree/main/exercises"
click node_combined "https://github.com/ruhanazevedo/free-exercise-db/blob/main/dist/exercises.json"
click node_images "https://github.com/ruhanazevedo/free-exercise-db/tree/main/exercises"
click node_app "https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/App.vue"
click node_search "https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/SearchBar.vue"
click node_instructions "https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/ExerciseInstructions.vue"
click node_gallery "https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/PhotoGallery.vue"

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_records,node_combined,node_images toneBlue
class node_app,node_search,node_saved toneAmber
class node_instructions,node_gallery toneMint
class node_visitor,node_imagekit toneIndigo
```

## Components

### Exercise content

- [Exercise records](https://github.com/ruhanazevedo/free-exercise-db/tree/main/exercises): `exercises`
- [Combined dataset](https://github.com/ruhanazevedo/free-exercise-db/blob/main/dist/exercises.json): `dist/exercises.json`
- [Exercise images](https://github.com/ruhanazevedo/free-exercise-db/tree/main/exercises): `exercises`

### Browse frontend

- [App shell](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/App.vue): `site/src/App.vue`
- [Search and bookmarks](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/SearchBar.vue): `site/src/components/SearchBar.vue`
- **Saved exercises**

### Exercise presentation

- [Instructions view](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/ExerciseInstructions.vue): `site/src/components/ExerciseInstructions.vue`
- [Photo gallery](https://github.com/ruhanazevedo/free-exercise-db/blob/main/site/src/components/PhotoGallery.vue): `site/src/components/PhotoGallery.vue`

### Other components

- **Visitor**
- **ImageKit**

## Connections

- Visitor → App shell: opens frontend (evidence: `README.md`)
- App shell → Search and bookmarks: renders (evidence: `site/src/App.vue`)
- Search and bookmarks → Combined dataset: loads records (evidence: `site/src/components/SearchBar.vue`)
- Exercise records → Exercise images: references images (evidence: `README.md`)
- Search and bookmarks → Visitor: shows results (evidence: `site/src/components/SearchBar.vue`)
- Search and bookmarks → Instructions view: renders (evidence: `site/src/components/SearchBar.vue`)
- Search and bookmarks → Photo gallery: renders (evidence: `site/src/components/SearchBar.vue`)
- Search and bookmarks → Saved exercises: reads and writes (evidence: `site/src/components/SearchBar.vue`)
- Photo gallery → ImageKit: requests resized photos (evidence: `site/src/components/PhotoGallery.vue`)
- Photo gallery → Exercise images: selects photo paths (evidence: `site/src/components/PhotoGallery.vue`)
