jellyfin/jellyfin-design

Jellyfin Design is a small project that holds the "design tokens" for Jellyfin, the open-source media server. Design tokens are the fundamental building blocks of a visual style, things like exact color values, spacing measurements, font sizes, and border radii. Instead of hardcoding these values scattered across different apps and components, this repo keeps them in one centralized place so the entire Jellyfin ecosystem stays visually consistent. The repo uses a tool called StyleDictionary to take those design tokens (written in a standardized JSON format) and automatically translate them into formats that different platforms can actually use. For example, the same "primary blue" color definition can be converted into CSS variables for a web app, XML resources for Android, or Swift code for iOS. Running a single build command processes all the token definitions and outputs platform-specific files. This kind of project matters most for teams maintaining apps across multiple platforms. If Jellyfin ships on web, desktop, mobile, and TV interfaces, keeping the look and feel consistent across all of them is a real challenge. A designer might adjust a shade of gray or change a button's corner radius once here, and every app can pull in the updated value rather than having someone manually hunt down and update that color in dozens of separate codebases. The README is quite sparse, it covers just the tooling setup and a single build command. There's no detailed documentation about the full token structure, contribution guidelines, or how the outputs get consumed by the main Jellyfin applications. What's notable is that this is a focused, utility-level project: it's not an app itself, but rather the single source of truth that other Jellyfin projects depend on for their visual styling decisions.