# vtolochk/hypertube architecture

> Architecture diagram of the GitHub repository vtolochk/hypertube, 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/vtolochk/hypertube
- Repository: https://github.com/vtolochk/hypertube

## Overview

Hypertube is a web app for finding and watching videos, with account creation, OAuth, profiles, and account settings. A user enters through the Vue app, searches or navigates the movie experience, and can watch a selected video; the backend exposes separate movie and user API routers. The tree documents streaming, subtitles, comments, and watched status as distinct movie capabilities. The shown excerpts establish app/server wiring and several user API calls, but do not show movie request details or most backend route implementations, so those relationships are not asserted.

Main entry points: [`backend/src/api/routers/movie`](https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/movie) (Movie endpoints), [`frontend/src/components/includes/TheHeader.vue`](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/includes/TheHeader.vue) (Header and login), [`frontend/src/main.js`](https://github.com/vtolochk/hypertube/blob/master/frontend/src/main.js) (Vue entry), [`backend/src/api/index.js`](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/index.js) (API router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App state<br/>[App.vue]"]
  node_entry["Vue entry<br/>[main.js]"]
  node_navigation["Page routing<br/>[index.js]"]
  node_header["Header and login<br/>[TheHeader.vue]"]
  node_http["HTTP client<br/>[http-common.js]"]
  node_token["Auth token<br/>[setAuthToken.js]"]
end

subgraph group_movies["Movie experience"]
  node_search["Movie search<br/>[SearchBar.vue]"]
  node_date["Date filter<br/>[DatePicker.vue]"]
  node_catalog["Movie browsing<br/>[Movies.vue]"]
  node_movie["Movie details<br/>[Movie.vue]"]
  node_comments["Movie comments<br/>[Comments.vue]"]
end

subgraph group_accounts["Accounts"]
  node_login["Login form<br/>[LogInForm.vue]"]
  node_account_ui["Profile and settings<br/>[UserSettings.vue]"]
  node_oauth_ui["OAuth callback<br/>[Oauth.vue]"]
end

subgraph group_backend["API backend"]
  node_server["HTTP server<br/>[server.js]"]
  node_api["API router<br/>[index.js]"]
  node_movie_api["Movie endpoints"]
  node_stream["Video streaming<br/>[stream.js]"]
  node_subtitle["Subtitle endpoint<br/>[subtitle.js]"]
  node_watched["Watched status<br/>[watched.js]"]
  node_comments_api["Comment endpoint<br/>[comment.js]"]
  node_user_api["User endpoints"]
  node_user_models["User models"]
  node_mailer["Mail delivery<br/>[Mailer.js]"]
end

node_viewer(("Viewer"))
node_mongo[("MongoDB")]

node_viewer -->|"uses"| node_entry
node_entry -->|"mounts"| node_app
node_entry -->|"configures"| node_navigation
node_app -->|"renders"| node_header
node_header -->|"renders"| node_login
node_search -->|"renders"| node_date
node_header -->|"requests"| node_http
node_header -->|"updates"| node_token
node_account_ui -->|"requests"| node_http
node_account_ui -->|"updates"| node_token
node_oauth_ui -->|"requests"| node_http
node_oauth_ui -->|"updates"| node_token
node_server -->|"routes API"| node_api
node_server -.->|"connects"| node_mongo
node_api -->|"registers"| node_user_api
node_api -->|"registers"| node_movie_api
node_user_api -.->|"uses"| node_user_models
node_user_models -->|"exports"| node_mailer
node_movie_api -.->|"routes"| node_stream
node_movie_api -.->|"routes"| node_subtitle
node_movie_api -.->|"routes"| node_watched
node_movie_api -.->|"routes"| node_comments_api

click node_app "https://github.com/vtolochk/hypertube/blob/master/frontend/src/App.vue"
click node_entry "https://github.com/vtolochk/hypertube/blob/master/frontend/src/main.js"
click node_navigation "https://github.com/vtolochk/hypertube/blob/master/frontend/src/router/index.js"
click node_header "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/includes/TheHeader.vue"
click node_login "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/LogInForm.vue"
click node_search "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/SearchBar.vue"
click node_date "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/DatePicker.vue"
click node_catalog "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Movies.vue"
click node_movie "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Movie.vue"
click node_comments "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Comments.vue"
click node_account_ui "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/UserSettings.vue"
click node_oauth_ui "https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Oauth.vue"
click node_http "https://github.com/vtolochk/hypertube/blob/master/frontend/src/http-common.js"
click node_token "https://github.com/vtolochk/hypertube/blob/master/frontend/src/utils/setAuthToken.js"
click node_server "https://github.com/vtolochk/hypertube/blob/master/backend/src/server.js"
click node_api "https://github.com/vtolochk/hypertube/blob/master/backend/src/api/index.js"
click node_movie_api "https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/movie"
click node_stream "https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/stream.js"
click node_subtitle "https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/subtitle.js"
click node_watched "https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/watched.js"
click node_comments_api "https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/comment.js"
click node_user_api "https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/user"
click node_user_models "https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/user/models"
click node_mailer "https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/user/models/Mailer.js"

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_app,node_entry,node_navigation,node_header,node_http,node_token,node_viewer toneBlue
class node_search,node_date,node_catalog,node_movie,node_comments,node_mongo toneAmber
class node_login,node_account_ui,node_oauth_ui toneMint
class node_server,node_api,node_movie_api,node_stream,node_subtitle,node_watched,node_comments_api,node_user_api,node_user_models,node_mailer toneRose
```

## Components

### Web client

- [App state](https://github.com/vtolochk/hypertube/blob/master/frontend/src/App.vue): `frontend/src/App.vue`
- [Vue entry](https://github.com/vtolochk/hypertube/blob/master/frontend/src/main.js): `frontend/src/main.js`
- [Page routing](https://github.com/vtolochk/hypertube/blob/master/frontend/src/router/index.js): `frontend/src/router/index.js`
- [Header and login](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/includes/TheHeader.vue): `frontend/src/components/includes/TheHeader.vue`
- [HTTP client](https://github.com/vtolochk/hypertube/blob/master/frontend/src/http-common.js): `frontend/src/http-common.js`
- [Auth token](https://github.com/vtolochk/hypertube/blob/master/frontend/src/utils/setAuthToken.js): `frontend/src/utils/setAuthToken.js`

### Movie experience

- [Movie search](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/SearchBar.vue): `frontend/src/components/SearchBar.vue`
- [Date filter](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/DatePicker.vue): `frontend/src/components/DatePicker.vue`
- [Movie browsing](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Movies.vue): `frontend/src/components/Movies.vue`
- [Movie details](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Movie.vue): `frontend/src/components/Movie.vue`
- [Movie comments](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Comments.vue): `frontend/src/components/Comments.vue`

### Accounts

- [Login form](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/LogInForm.vue): `frontend/src/components/LogInForm.vue`
- [Profile and settings](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/UserSettings.vue): `frontend/src/components/UserSettings.vue`
- [OAuth callback](https://github.com/vtolochk/hypertube/blob/master/frontend/src/components/Oauth.vue): `frontend/src/components/Oauth.vue`

### API backend

- [HTTP server](https://github.com/vtolochk/hypertube/blob/master/backend/src/server.js): `backend/src/server.js`
- [API router](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/index.js): `backend/src/api/index.js`
- [Movie endpoints](https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/movie): `backend/src/api/routers/movie`
- [Video streaming](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/stream.js): `backend/src/api/routers/movie/stream.js`
- [Subtitle endpoint](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/subtitle.js): `backend/src/api/routers/movie/subtitle.js`
- [Watched status](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/watched.js): `backend/src/api/routers/movie/watched.js`
- [Comment endpoint](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/movie/comment.js): `backend/src/api/routers/movie/comment.js`
- [User endpoints](https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/user): `backend/src/api/routers/user`
- [User models](https://github.com/vtolochk/hypertube/tree/master/backend/src/api/routers/user/models): `backend/src/api/routers/user/models`
- [Mail delivery](https://github.com/vtolochk/hypertube/blob/master/backend/src/api/routers/user/models/Mailer.js): `backend/src/api/routers/user/models/Mailer.js`

### Other components

- **Viewer**
- **MongoDB**

## Connections

- Viewer → Vue entry: uses
- Vue entry → App state: mounts (evidence: `frontend/src/main.js`)
- Vue entry → Page routing: configures (evidence: `frontend/src/main.js`)
- App state → Header and login: renders (evidence: `frontend/src/App.vue`)
- Header and login → Login form: renders (evidence: `frontend/src/components/includes/TheHeader.vue`)
- Movie search → Date filter: renders (evidence: `frontend/src/components/SearchBar.vue`)
- Header and login → HTTP client: requests (evidence: `frontend/src/components/includes/TheHeader.vue`)
- Header and login → Auth token: updates (evidence: `frontend/src/components/includes/TheHeader.vue`)
- Profile and settings → HTTP client: requests (evidence: `frontend/src/components/UserSettings.vue`)
- Profile and settings → Auth token: updates (evidence: `frontend/src/components/UserSettings.vue`)
- OAuth callback → HTTP client: requests (evidence: `frontend/src/components/Oauth.vue`)
- OAuth callback → Auth token: updates (evidence: `frontend/src/components/Oauth.vue`)
- HTTP server → API router: routes API (evidence: `backend/src/server.js`)
- HTTP server → MongoDB: connects
- API router → User endpoints: registers (evidence: `backend/src/api/index.js`)
- API router → Movie endpoints: registers (evidence: `backend/src/api/index.js`)
- User endpoints → User models: uses (evidence: `backend/src/api/routers/user/oauth/github.js`)
- User models → Mail delivery: exports (evidence: `backend/src/api/routers/user/models/index.js`)
- Movie endpoints → Video streaming: routes
- Movie endpoints → Subtitle endpoint: routes
- Movie endpoints → Watched status: routes
- Movie endpoints → Comment endpoint: routes
