# jellyfin/jellyfin-vue architecture

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

- Interactive diagram: https://gitdiagram.com/jellyfin/jellyfin-vue
- Repository: https://github.com/jellyfin/jellyfin-vue

## Overview

#### Overview

Jellyfin Vue is an experimental Vue-based browser client for Jellyfin, not a replacement for the main Jellyfin Web client. The primary product is the frontend under `packages/frontend/src`. A browser or desktop host serves its assets; the selected Jellyfin server is the documented application backend. Hosted deployments serve static assets, after which the client connects directly to the configured Jellyfin server.

#### Core components

- **Application bootstrap and shell — `packages/frontend/src/main.ts`:** Frontend entry point, with the application shell represented by the Vue app, layouts, plugins, and global styles.

- **Route and page surface — `packages/frontend/src/pages`:** User-facing routes for libraries, media details, search, playback, server selection/login, settings, administration, and setup.

- **Reusable UI and media controls — `packages/frontend/src/components`:** Vue components for navigation, item cards, dialogs, metadata editing, playback controls, images, users, and system feedback.

- **Jellyfin server integration — `packages/frontend/src/plugins/remote`:** Remote authentication, HTTP integration, socket support, SDK-related code, and server-facing types. This is the boundary to the externally selected Jellyfin server.

- **Client state and local data — `packages/frontend/src/store`:** Client stores for settings, API-oriented data, playback, task management, and shared/synchronized state. The tree indicates database-oriented client storage areas, but not their exact persistence behavior.

- **Shared UI toolkit — `packages/ui-toolkit/src/components`:** Reusable Vue components and supporting composables/utilities intended to be consumed by frontend-facing packages.

- **Localization — `packages/i18n/src/index.ts`:** Localization package entry area, backed by the language resources under `packages/i18n/strings`.

- **Cross-environment utilities — `packages/shared/src/universal`:** Shared browser/universal helpers such as HTML, promise, and validation utilities.

- **Optional desktop runtime — `packages/tauri-runtime/entrypoint.ts`:** Tauri-specific runtime support. Native packaging is separately represented under `packaging/tauri/src`; it is an alternate host for the frontend rather than part of the normal hosted-browser path.

#### Public and external interfaces

The principal application entry is `packages/frontend/src/main.ts`. Named package source entry files also include `packages/i18n/src/index.ts` and the toolkit component index at `packages/ui-toolkit/src/components/index.ts`; exact exports are not verifiable from the tree alone. External actors are the user’s browser or desktop host and the Jellyfin server selected by that user. The README states that the client does not proxy normal frontend/server traffic through the asset host.

#### Relationships

The host loads the frontend entry point, which presents routed pages and reusable components. Those UI areas are organized alongside composables and stores that represent client settings, server data, playback, and tasks. Server-facing operations are owned by the remote integration area, while shared utilities, localization, and the UI toolkit provide reusable support. Tauri and packaging directories provide alternative runtime/distribution boundaries; they are not sequential stages in the browser application pipeline.

Main entry points: [`packages/frontend/src/main.ts`](https://github.com/jellyfin/jellyfin-vue/blob/master/packages/frontend/src/main.ts) (Application Bootstrap), [`packages/frontend/src/pages`](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/pages) (Routes and Pages), [`packages/frontend/src/plugins/remote`](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/plugins/remote) (Jellyfin Integration), [`packages/tauri-runtime/entrypoint.ts`](https://github.com/jellyfin/jellyfin-vue/blob/master/packages/tauri-runtime/entrypoint.ts) (Tauri Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_host(("Browser/Desktop Host<br/>external host"))
node_bootstrap["Application Bootstrap<br/>Vue application entry<br/>[main.ts]"]
node_pages["Routes and Pages<br/>frontend route surface"]
node_components["UI and Media Controls<br/>Vue component library"]
node_remote["Jellyfin Integration<br/>server integration"]
node_store[("Client State and Data<br/>client state layer")]
node_toolkit["Shared UI Toolkit<br/>reusable UI package"]
node_i18n["Localization<br/>[index.ts]"]
node_shared["Universal Utilities<br/>cross-environment utilities"]
node_tauri["Tauri Runtime<br/>desktop runtime<br/>[entrypoint.ts]"]
node_packaging["Tauri Packaging<br/>native packaging boundary"]
node_server(("Selected Jellyfin Server<br/>external application backend"))

node_host -->|"loads"| node_bootstrap
node_tauri -.->|"hosts"| node_bootstrap
node_bootstrap -->|"presents"| node_pages
node_pages -->|"uses"| node_components
node_pages -->|"uses"| node_store
node_pages -->|"uses"| node_remote
node_toolkit -->|"supports"| node_components
node_i18n -->|"localizes"| node_bootstrap
node_shared -->|"supports"| node_bootstrap
node_remote -->|"connects to"| node_server
node_packaging -.->|"packages"| node_tauri

click node_bootstrap "https://github.com/jellyfin/jellyfin-vue/blob/master/packages/frontend/src/main.ts"
click node_pages "https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/pages"
click node_components "https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/components"
click node_remote "https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/plugins/remote"
click node_store "https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/store"
click node_toolkit "https://github.com/jellyfin/jellyfin-vue/tree/master/packages/ui-toolkit/src/components"
click node_i18n "https://github.com/jellyfin/jellyfin-vue/blob/master/packages/i18n/src/index.ts"
click node_shared "https://github.com/jellyfin/jellyfin-vue/tree/master/packages/shared/src/universal"
click node_tauri "https://github.com/jellyfin/jellyfin-vue/blob/master/packages/tauri-runtime/entrypoint.ts"
click node_packaging "https://github.com/jellyfin/jellyfin-vue/tree/master/packaging/tauri/src"

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_host,node_bootstrap,node_pages,node_components,node_remote,node_store,node_toolkit,node_i18n,node_shared,node_tauri,node_packaging,node_server toneNeutral
```

## Components

### Other components

- **Browser/Desktop Host**: external host · Loads the hosted frontend assets or provides the desktop host.
- [Application Bootstrap](https://github.com/jellyfin/jellyfin-vue/blob/master/packages/frontend/src/main.ts): Vue application entry · Bootstraps the Vue app, shell, layouts, plugins, and global styles. · `packages/frontend/src/main.ts`
- [Routes and Pages](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/pages): frontend route surface · Provides user-facing library, playback, login, settings, and administration routes. · `packages/frontend/src/pages`
- [UI and Media Controls](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/components): Vue component library · Provides reusable navigation, media, metadata, playback, and feedback components. · `packages/frontend/src/components`
- [Jellyfin Integration](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/plugins/remote): server integration · Owns authentication, HTTP, sockets, SDK-related code, and server-facing types. · `packages/frontend/src/plugins/remote`
- [Client State and Data](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/frontend/src/store): client state layer · Holds settings, server data, playback, tasks, and shared synchronized state. · `packages/frontend/src/store`
- [Shared UI Toolkit](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/ui-toolkit/src/components): reusable UI package · Supplies reusable Vue components and supporting composables. · `packages/ui-toolkit/src/components`
- [Localization](https://github.com/jellyfin/jellyfin-vue/blob/master/packages/i18n/src/index.ts): localization package · Provides localization backed by language resources. · `packages/i18n/src/index.ts`
- [Universal Utilities](https://github.com/jellyfin/jellyfin-vue/tree/master/packages/shared/src/universal): cross-environment utilities · Provides shared browser and universal helpers. · `packages/shared/src/universal`
- [Tauri Runtime](https://github.com/jellyfin/jellyfin-vue/blob/master/packages/tauri-runtime/entrypoint.ts): desktop runtime · Provides an optional alternate desktop host for the frontend. · `packages/tauri-runtime/entrypoint.ts`
- [Tauri Packaging](https://github.com/jellyfin/jellyfin-vue/tree/master/packaging/tauri/src): native packaging boundary · Provides native distribution support for the desktop runtime. · `packaging/tauri/src`
- **Selected Jellyfin Server**: external application backend · Receives direct server-facing operations from the client.

## Connections

- Browser/Desktop Host → Application Bootstrap: loads
- Tauri Runtime → Application Bootstrap: hosts
- Application Bootstrap → Routes and Pages: presents
- Routes and Pages → UI and Media Controls: uses
- Routes and Pages → Client State and Data: uses
- Routes and Pages → Jellyfin Integration: uses
- Shared UI Toolkit → UI and Media Controls: supports
- Localization → Application Bootstrap: localizes
- Universal Utilities → Application Bootstrap: supports
- Jellyfin Integration → Selected Jellyfin Server: connects to
- Tauri Packaging → Tauri Runtime: packages
