# kyanowo1107/meowstatus architecture

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

- Interactive diagram: https://gitdiagram.com/kyanowo1107/meowstatus
- Repository: https://github.com/kyanowo1107/meowstatus

## Overview

MeowStatus is a personal status hub: visitors read a public dashboard, while an administrator authenticates to manage profile status, widgets, themes, copy, and local assets. Enabled widgets are periodically or manually refreshed through provider plugins; their snapshots and configuration feed the dashboard. The source excerpts show the poller/store/provider calls and selected API/UI interactions; broader admin routing and dashboard capabilities are documented in the README, so those links cite it.

Main entry points: [`app/store.py`](https://github.com/kyanowo1107/meowstatus/blob/master/app/store.py) (Status store), [`app/static/admin.js`](https://github.com/kyanowo1107/meowstatus/blob/master/app/static/admin.js) (Admin console), [`app/main.py`](https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py) (HTTP application), [`app/poller.py`](https://github.com/kyanowo1107/meowstatus/blob/master/app/poller.py) (Widget poller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_public_ui["Public dashboard<br/>[public.js]"]
  node_admin_ui["Admin console<br/>[admin.js]"]
  node_theme_ui["Theme renderer<br/>[theme.js]"]
end

subgraph group_api["Application API"]
  node_http_server["HTTP application<br/>[main.py]"]
  node_configuration["Runtime configuration<br/>[config.py]"]
  node_auth["Admin authentication<br/>[main.py]"]
  node_profile_api["Profile and dashboard API<br/>[main.py]"]
  node_widget_api["Widget management API<br/>[main.py]"]
  node_appearance_api["Theme and assets API<br/>[main.py]"]
end

subgraph group_widgets["Widget monitoring"]
  node_poller["Widget poller<br/>[poller.py]"]
  node_registry["Provider registry<br/>[base.py]"]
  node_provider_contract["Provider contract<br/>[base.py]"]
  node_minecraft_provider["Minecraft providers<br/>[minecraft.py]"]
  node_http_provider["HTTP service provider<br/>[service.py]"]
end

subgraph group_state["Persistent settings"]
  node_store[("Status store<br/>[store.py]")]
end

node_visitor(("Visitor"))
node_administrator(("Administrator"))
node_minecraft_servers["Minecraft servers"]
node_monitored_services["Monitored services"]
node_local_assets["Local asset files"]

node_visitor -->|"views"| node_public_ui
node_public_ui -->|"requests dashboard"| node_http_server
node_http_server -->|"routes reads"| node_profile_api
node_administrator -->|"manages"| node_admin_ui
node_admin_ui -->|"authenticates"| node_auth
node_admin_ui -->|"manages widgets"| node_widget_api
node_admin_ui -->|"loads dashboard"| node_profile_api
node_admin_ui -->|"saves appearance"| node_appearance_api
node_theme_ui -->|"loads theme"| node_appearance_api
node_http_server -->|"loads settings"| node_configuration
node_http_server -->|"starts polling"| node_poller
node_http_server -->|"uses persistence"| node_store
node_profile_api -->|"reads status"| node_store
node_widget_api -->|"manages records"| node_store
node_appearance_api -->|"persists settings"| node_store
node_poller -->|"loads widgets"| node_store
node_poller -->|"dispatches provider"| node_registry
node_poller -->|"writes snapshots"| node_store
node_minecraft_provider -->|"implements"| node_provider_contract
node_http_provider -->|"implements"| node_provider_contract
node_minecraft_provider -->|"queries"| node_minecraft_servers
node_http_provider -->|"checks endpoint"| node_monitored_services
node_appearance_api -->|"serves configured files"| node_local_assets

click node_public_ui "https://github.com/kyanowo1107/meowstatus/blob/master/app/static/public.js"
click node_admin_ui "https://github.com/kyanowo1107/meowstatus/blob/master/app/static/admin.js"
click node_theme_ui "https://github.com/kyanowo1107/meowstatus/blob/master/app/static/theme.js"
click node_http_server "https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py"
click node_configuration "https://github.com/kyanowo1107/meowstatus/blob/master/app/config.py"
click node_auth "https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py"
click node_profile_api "https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py"
click node_widget_api "https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py"
click node_appearance_api "https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py"
click node_poller "https://github.com/kyanowo1107/meowstatus/blob/master/app/poller.py"
click node_registry "https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/base.py"
click node_provider_contract "https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/base.py"
click node_minecraft_provider "https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/minecraft.py"
click node_http_provider "https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/service.py"
click node_store "https://github.com/kyanowo1107/meowstatus/blob/master/app/store.py"

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_public_ui,node_admin_ui,node_theme_ui toneBlue
class node_http_server,node_configuration,node_auth,node_profile_api,node_widget_api,node_appearance_api toneAmber
class node_poller,node_registry,node_provider_contract,node_minecraft_provider,node_http_provider,node_minecraft_servers toneMint
class node_store toneRose
class node_visitor,node_administrator,node_monitored_services,node_local_assets toneIndigo
```

## Components

### Web experience

- [Public dashboard](https://github.com/kyanowo1107/meowstatus/blob/master/app/static/public.js): `app/static/public.js`
- [Admin console](https://github.com/kyanowo1107/meowstatus/blob/master/app/static/admin.js): `app/static/admin.js`
- [Theme renderer](https://github.com/kyanowo1107/meowstatus/blob/master/app/static/theme.js): `app/static/theme.js`

### Application API

- [HTTP application](https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py): `app/main.py`
- [Runtime configuration](https://github.com/kyanowo1107/meowstatus/blob/master/app/config.py): `app/config.py`
- [Admin authentication](https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py): `app/main.py`
- [Profile and dashboard API](https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py): `app/main.py`
- [Widget management API](https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py): `app/main.py`
- [Theme and assets API](https://github.com/kyanowo1107/meowstatus/blob/master/app/main.py): `app/main.py`

### Widget monitoring

- [Widget poller](https://github.com/kyanowo1107/meowstatus/blob/master/app/poller.py): `app/poller.py`
- [Provider registry](https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/base.py): `app/plugins/base.py`
- [Provider contract](https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/base.py): `app/plugins/base.py`
- [Minecraft providers](https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/minecraft.py): `app/plugins/minecraft.py`
- [HTTP service provider](https://github.com/kyanowo1107/meowstatus/blob/master/app/plugins/service.py): `app/plugins/service.py`

### Persistent settings

- [Status store](https://github.com/kyanowo1107/meowstatus/blob/master/app/store.py): `app/store.py`

### Other components

- **Visitor**
- **Administrator**
- **Minecraft servers**
- **Monitored services**
- **Local asset files**

## Connections

- Visitor → Public dashboard: views (evidence: `README.md`)
- Public dashboard → HTTP application: requests dashboard (evidence: `app/static/public.js`)
- HTTP application → Profile and dashboard API: routes reads (evidence: `README.md`)
- Administrator → Admin console: manages (evidence: `README.md`)
- Admin console → Admin authentication: authenticates (evidence: `README.md`)
- Admin console → Widget management API: manages widgets (evidence: `app/static/admin.js`)
- Admin console → Profile and dashboard API: loads dashboard (evidence: `app/static/admin.js`)
- Admin console → Theme and assets API: saves appearance (evidence: `README.md`)
- Theme renderer → Theme and assets API: loads theme (evidence: `app/static/theme.js`)
- HTTP application → Runtime configuration: loads settings (evidence: `app/main.py`)
- HTTP application → Widget poller: starts polling (evidence: `app/main.py`)
- HTTP application → Status store: uses persistence (evidence: `app/main.py`)
- Profile and dashboard API → Status store: reads status (evidence: `app/main.py`)
- Widget management API → Status store: manages records (evidence: `app/main.py`)
- Theme and assets API → Status store: persists settings (evidence: `app/main.py`)
- Widget poller → Status store: loads widgets (evidence: `app/poller.py`)
- Widget poller → Provider registry: dispatches provider (evidence: `app/poller.py`)
- Widget poller → Status store: writes snapshots (evidence: `app/poller.py`)
- Minecraft providers → Provider contract: implements (evidence: `app/plugins/minecraft.py`)
- HTTP service provider → Provider contract: implements (evidence: `app/plugins/service.py`)
- Minecraft providers → Minecraft servers: queries (evidence: `README.md`)
- HTTP service provider → Monitored services: checks endpoint (evidence: `app/plugins/service.py`)
- Theme and assets API → Local asset files: serves configured files (evidence: `README.md`)
