# ogdrneutron/neutronos architecture

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

- Interactive diagram: https://gitdiagram.com/ogdrneutron/neutronos
- Repository: https://github.com/ogdrneutron/neutronos

## Overview

This checkout is an NeutronOS application-catalog and package repository, not the shell or OS implementation described by the README. It contains an app index and signed application bundles; no source excerpts show the catalog’s runtime behavior or how packages are installed and launched. The README describes the broader controller-first platform and its application areas, but those capabilities should not be mistaken for implementations in this tree.

Main entry points: [`Apps`](https://github.com/ogdrneutron/neutronos/tree/main/Apps) (Signed app bundles), [`Apps/index.json`](https://github.com/ogdrneutron/neutronos/blob/main/Apps/index.json) (App index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["App catalog"]
  node_app_index["App index<br/>[index.json]"]
  node_app_bundles["Signed app bundles"]
end

subgraph group_apps["Application bundles"]
  node_browser["Browser<br/>[Browser.Napp]"]
  node_codex["Codex<br/>[Codex.Napp]"]
  node_gallery["Gallery<br/>[Gallery.Napp]"]
  node_games["Games<br/>[Games.Napp]"]
  node_music["Music Player<br/>[MusicPlayer.Napp]"]
  node_media_optimizer["Media Optimizer"]
  node_media_libraries["Media Libraries"]
  node_torrent["Torrent client<br/>[qBittorrent.Napp]"]
  node_text_editor["Text Editor<br/>[TextEditor.Napp]"]
  node_network_tools["Network tools"]
  node_controllers["Custom controllers"]
end

subgraph group_platform["NeutronOS platform"]
  node_shell["NeutronShell"]
end

node_user(("NeutronOS user"))

node_user -->|"navigates"| node_shell
node_shell -->|"hosts applications"| node_app_bundles
node_app_index -.->|"catalogs packages"| node_app_bundles

click node_app_index "https://github.com/ogdrneutron/neutronos/blob/main/Apps/index.json"
click node_app_bundles "https://github.com/ogdrneutron/neutronos/tree/main/Apps"
click node_browser "https://github.com/ogdrneutron/neutronos/blob/main/Apps/Browser.Napp"
click node_codex "https://github.com/ogdrneutron/neutronos/blob/main/Apps/Codex.Napp"
click node_gallery "https://github.com/ogdrneutron/neutronos/blob/main/Apps/Gallery.Napp"
click node_games "https://github.com/ogdrneutron/neutronos/blob/main/Apps/Games.Napp"
click node_music "https://github.com/ogdrneutron/neutronos/blob/main/Apps/MusicPlayer.Napp"
click node_media_optimizer "https://github.com/ogdrneutron/neutronos/blob/main/Apps/MediaOptimizer.Napp"
click node_media_libraries "https://github.com/ogdrneutron/neutronos/blob/main/Apps/NeutronMediaLibraries.Napp"
click node_torrent "https://github.com/ogdrneutron/neutronos/blob/main/Apps/qBittorrent.Napp"
click node_text_editor "https://github.com/ogdrneutron/neutronos/blob/main/Apps/TextEditor.Napp"
click node_network_tools "https://github.com/ogdrneutron/neutronos/blob/main/Apps/NeutronRemoteSystems.Napp"
click node_controllers "https://github.com/ogdrneutron/neutronos/blob/main/Apps/CustomControllers.Napp"

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_index,node_app_bundles,node_user toneBlue
class node_browser,node_codex,node_gallery,node_games,node_music,node_media_optimizer,node_media_libraries,node_torrent,node_text_editor,node_network_tools,node_controllers toneAmber
class node_shell toneMint
```

## Components

### App catalog

- [App index](https://github.com/ogdrneutron/neutronos/blob/main/Apps/index.json): `Apps/index.json`
- [Signed app bundles](https://github.com/ogdrneutron/neutronos/tree/main/Apps): `Apps`

### Application bundles

- [Browser](https://github.com/ogdrneutron/neutronos/blob/main/Apps/Browser.Napp): `Apps/Browser.Napp`
- [Codex](https://github.com/ogdrneutron/neutronos/blob/main/Apps/Codex.Napp): `Apps/Codex.Napp`
- [Gallery](https://github.com/ogdrneutron/neutronos/blob/main/Apps/Gallery.Napp): `Apps/Gallery.Napp`
- [Games](https://github.com/ogdrneutron/neutronos/blob/main/Apps/Games.Napp): `Apps/Games.Napp`
- [Music Player](https://github.com/ogdrneutron/neutronos/blob/main/Apps/MusicPlayer.Napp): `Apps/MusicPlayer.Napp`
- [Media Optimizer](https://github.com/ogdrneutron/neutronos/blob/main/Apps/MediaOptimizer.Napp): `Apps/MediaOptimizer.Napp`
- [Media Libraries](https://github.com/ogdrneutron/neutronos/blob/main/Apps/NeutronMediaLibraries.Napp): `Apps/NeutronMediaLibraries.Napp`
- [Torrent client](https://github.com/ogdrneutron/neutronos/blob/main/Apps/qBittorrent.Napp): `Apps/qBittorrent.Napp`
- [Text Editor](https://github.com/ogdrneutron/neutronos/blob/main/Apps/TextEditor.Napp): `Apps/TextEditor.Napp`
- [Network tools](https://github.com/ogdrneutron/neutronos/blob/main/Apps/NeutronRemoteSystems.Napp): `Apps/NeutronRemoteSystems.Napp`
- [Custom controllers](https://github.com/ogdrneutron/neutronos/blob/main/Apps/CustomControllers.Napp): `Apps/CustomControllers.Napp`

### NeutronOS platform

- **NeutronShell**

### Other components

- **NeutronOS user**

## Connections

- NeutronOS user → NeutronShell: navigates (evidence: `README.md`)
- NeutronShell → Signed app bundles: hosts applications (evidence: `README.md`)
- App index → Signed app bundles: catalogs packages
