# and360red/solaris architecture

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

- Interactive diagram: https://gitdiagram.com/and360red/solaris
- Repository: https://github.com/and360red/solaris

## Overview

1. This repository is a distribution package for a Playnite fullscreen theme called “Solaris,” not an application with its own runtime. The core product is a set of theme resources that Playnite loads inside its fullscreen UI.

2. The main architecture boundary is external: Playnite is the host application, and Solaris plugs into Playnite’s fullscreen theme system. That means the repo mainly defines presentation, layout, and theme metadata rather than business logic or services.

3. `And360red_Solaris.yaml` is the primary theme descriptor. In a Playnite theme repo, this file typically acts as the theme identity/registration point that tells Playnite how to recognize the theme package and what to install.

4. `InstallerManifest.yaml` is the installation/deployment contract. It is the packaging layer that lets the theme be installed or updated through Playnite’s extension/theme mechanism rather than through a custom installer.

5. `Images/` contains the visual assets used in the README and likely illustrative marketing material for the theme. In architecture terms, these are non-runtime assets that document the UI states the theme supports, such as horizontal mode, vertical mode, game details, menus, and lock screen.

6. The README shows Solaris is designed around multiple fullscreen layouts and screens, including horizontal and vertical browsing, game detail views, menus, lock screen, and plugin-aware views. That suggests the theme is organized around different UI states rather than around modules or services.

7. A major integration boundary is Playnite plugins. The README explicitly lists supported plugins such as CheckDLC, Extra Metadata Loader, HowLongToBeat, Library Management, Now Playing, Achievements, Screenshots Visualizer, Steam News and Players Viewer, Theme Options, and UniPlaySong. This means the theme has UI hooks or styling expectations for plugin-provided data surfaces.

8. Crowdin localization support is referenced in the README, indicating the theme is intended to be translated externally. That implies text resources are likely managed separately from the theme visuals, with localization as a secondary content pipeline.

9. The repository also includes `.github/FUNDING.yml`, which is operational rather than product logic. It signals project funding support through GitHub, but it does not affect the runtime architecture of the theme itself.

10. Overall, the architecture is a thin packaging-and-assets repo: theme metadata plus UI resources, installed into Playnite as a fullscreen theme, with compatibility considerations for several extension plugins. The important diagram boundary is between Playnite host runtime and the theme’s packaged presentation assets.

Main entry points: [`README.md`](https://github.com/and360red/solaris/blob/main/README.md) (README), [`And360red_Solaris.yaml`](https://github.com/and360red/solaris/blob/main/And360red_Solaris.yaml) (Theme YAML), [`InstallerManifest.yaml`](https://github.com/and360red/solaris/blob/main/InstallerManifest.yaml) (Install manifest), [`Images`](https://github.com/and360red/solaris/tree/main/Images) (Images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_external["External host and integrations"]
  node_playnite["Playnite fullscreen<br/>host runtime"]
  node_plugins["Plugin surfaces<br/>integration surfaces"]
  node_crowdin["Crowdin<br/>localization pipeline"]
end

subgraph group_repo["Solaris package"]
  node_theme["Solaris theme<br/>fullscreen theme package"]
  node_descriptor["Theme YAML<br/>theme descriptor"]
  node_manifest["Install manifest<br/>packaging contract"]
  node_assets["Images<br/>ui assets"]
  node_readme["README<br/>documentation<br/>[README.md]"]
  node_funding["Funding config<br/>repo ops<br/>[FUNDING.yml]"]
end

node_descriptor -->|"defines"| node_theme
node_manifest -->|"installs"| node_theme
node_assets -->|"illustrates"| node_theme
node_readme -->|"documents"| node_theme
node_theme -->|"loads into"| node_playnite
node_theme -->|"styles"| node_plugins
node_readme -.->|"lists"| node_plugins
node_readme -.->|"mentions"| node_crowdin
node_funding -.->|"supports"| node_theme

click node_descriptor "https://github.com/and360red/solaris/blob/main/And360red_Solaris.yaml"
click node_manifest "https://github.com/and360red/solaris/blob/main/InstallerManifest.yaml"
click node_assets "https://github.com/and360red/solaris/tree/main/Images"
click node_readme "https://github.com/and360red/solaris/blob/main/README.md"
click node_funding "https://github.com/and360red/solaris/blob/main/.github/FUNDING.yml"

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_playnite,node_plugins,node_crowdin toneBlue
class node_theme,node_descriptor,node_manifest,node_assets,node_readme,node_funding toneAmber
```

## Components

### External host and integrations

Systems outside the repo that Solaris depends on or integrates with.

- **Playnite fullscreen**: host runtime · The external application that loads and renders the Solaris fullscreen theme.
- **Plugin surfaces**: integration surfaces · UI areas and data hooks for Playnite plugins such as metadata, achievements, playback, news, and utilities.
- **Crowdin**: localization pipeline · External translation workflow referenced for theme text localization.

### Solaris package

Theme metadata, packaging, and presentation assets in this repository.

- **Solaris theme**: fullscreen theme package · The packaged Playnite fullscreen theme distributed by this repository.
- [Theme YAML](https://github.com/and360red/solaris/blob/main/And360red_Solaris.yaml): theme descriptor · Primary theme identity and registration file for Playnite. · `And360red_Solaris.yaml`
- [Install manifest](https://github.com/and360red/solaris/blob/main/InstallerManifest.yaml): packaging contract · Installation and update metadata for the theme package. · `InstallerManifest.yaml`
- [Images](https://github.com/and360red/solaris/tree/main/Images): ui assets · Visual screenshots and promotional assets showing the theme across fullscreen layouts and states. · `Images`
- [README](https://github.com/and360red/solaris/blob/main/README.md): documentation · Human-facing overview of the theme, supported layouts, and compatibility notes. · `README.md`
- [Funding config](https://github.com/and360red/solaris/blob/main/.github/FUNDING.yml): repo ops · GitHub funding metadata for project support. · `.github/FUNDING.yml`

## Connections

- Theme YAML → Solaris theme: defines · Registers and identifies the Solaris theme package.
- Install manifest → Solaris theme: installs · Provides packaging metadata for deployment and updates.
- Images → Solaris theme: illustrates · Contains screenshots and visual examples of the theme UI.
- README → Solaris theme: documents · Explains the theme, layouts, and supported plugin-aware views.
- Solaris theme → Playnite fullscreen: loads into · The theme is consumed by Playnite inside its fullscreen UI.
- Solaris theme → Plugin surfaces: styles · Provides presentation for plugin-provided data and screens.
- README → Plugin surfaces: lists · Documents supported plugin integrations and related UI surfaces.
- README → Crowdin: mentions · References external localization support.
- Funding config → Solaris theme: supports · Project funding metadata associated with the repository.
