Update Dev

.github/workflows/docs-sync.yaml

@@ -1,4 +1,6 @@
 name: Outline Sync
+permissions:
+  contents: write
 
 on:
   push:

.github/workflows/lint.yaml

@@ -19,5 +19,5 @@ jobs:
         run: |
           git config --global user.name 'actions-user'
           git config --global user.email 'its4nik@users.noreply.github.com'
-          git commit --allow-empty -am "chore(ci) [skip ci]: Lint"
+          git commit --allow-empty -am "chore(ci): Lint [skip ci]"
           git push

apps/docs/dockstat/README.md

@@ -0,0 +1,223 @@
+---
+id: 7dddd764-6483-4f84-96a3-988304e772d3
+title: DockStat
+collectionId: b4a5e48f-f103-480b-9f50-8f53f515cab9
+parentDocumentId: null
+updatedAt: 2025-12-17T09:43:38.464Z
+urlId: zqa4IyZtl0
+---
+
+![](/api/attachments.redirect?id=2c39d8bf-6a65-43f6-9781-287b6950d350 "full-width =2834x274")
+
+
+---
+
+
+:::warning
+***DockStat is currently under active alpha-development, expect breaking changes***
+
+:::
+
+
+---
+
+> ***DockStat is a Docker container monitoring and management platform built as a monorepo. The system consists of a Bun/Elysia backend API, a React Router frontend, companion services (DockNode, DockStore), and shared packages.***
+
+## Documentation Index
+
+| Section | Description |
+|----|----|
+| [Architecture](/doc/d56ca448-563a-4206-9585-c45f8f6be5cf) | System design, data flow, and component relationships |
+| [API Reference](/doc/b174143d-f906-4f8d-8cb5-9fc96512e575) | Complete REST API endpoint documentation |
+| [Apps overview](/doc/fb89c77f-9f0a-497a-bb24-c41d21b37478) | Guide to all DockStat applications |
+| [Configuration](/doc/dec1cb2c-9a13-4e67-a31c-d3a685391208) | Environment variables and settings |
+| [Integration guide](/doc/e4e04545-fd9f-4fbf-becb-94da81f48bc5) | Package interoperability and external integrations |
+| [Packages](/doc/bbcefaa2-6bd4-46e8-ae4b-a6b823593e67) | Shared package documentation |
+| [Troubleshooting](/doc/88a5f959-3f89-4266-9d8e-eb50193425b0) | Common issues and solutions |
+
+## Architecture
+
+```mermaidjs
+
+graph TB
+    subgraph Frontend
+        DS[dockstat<br/>React Router SSR]
+    end
+
+    subgraph Backend
+        API[api<br/>Elysia + Bun]
+        DCM[DockerClientManager]
+        PH[PluginHandler]
+        DB[(SQLite)]
+    end
+
+    subgraph Companion
+        DN[docknode<br/>Remote Agent]
+        DST[dockstore<br/>Plugin Registry]
+    end
+
+    subgraph Packages
+        PKG_DC["@dockstat/docker-client"]
+        PKG_DB["@dockstat/db"]
+        PKG_SW["@dockstat/sqlite-wrapper"]
+        PKG_PH["@dockstat/plugin-handler"]
+        PKG_LOG["@dockstat/logger"]
+        PKG_TYP["@dockstat/typings"]
+        PKG_UI["@dockstat/ui"]
+    end
+
+    DS -->|Eden client| API
+    API --> DCM
+    API --> PH
+    API --> DB
+    DCM --> PKG_DC
+    PH --> PKG_PH
+    DB --> PKG_DB
+    PKG_DB --> PKG_SW
+    DN -->|Stack deploy| API
+    DST -->|Plugin bundles| PH
+```
+
+## Repository Structure
+
+```
+apps/
+├── api/           Backend API (Elysia, prefix /api/v2)
+├── dockstat/      Frontend (React Router v7, SSR)
+├── docknode/      Remote agent for stack deployment
+├── dockstore/     Plugin and theme registry
+└── docs/          Documentation (this folder)
+
+packages/
+├── db/            Database layer (@dockstat/db)
+├── docker-client/ Docker operations (@dockstat/docker-client)
+├── logger/        Logging utility (@dockstat/logger)
+├── plugin-handler/Plugin system (@dockstat/plugin-handler)
+├── sqlite-wrapper/SQLite query builder (@dockstat/sqlite-wrapper)
+├── typings/       Shared types (@dockstat/typings)
+├── ui/            UI components (@dockstat/ui)
+└── utils/         Utilities (@dockstat/utils)
+```
+
+## Quick Start
+
+Install dependencies from the monorepo root:
+
+```bash
+bun install
+```
+
+Start the API in development mode:
+
+```bash
+cd apps/api
+
+bun run dev
+```
+
+Start the frontend in development mode:
+
+```bash
+cd apps/dockstat
+
+bun run dev
+```
+
+The API listens on port 9876 by default with prefix `/api/v2`. The frontend dev server runs on port 5173.
+
+## Applications
+
+| Application | Type | Port | Documentation |
+|----|----|----|----|
+| `dockstat` | Frontend | 5173 / 3000 | [Apps overview](/doc/fb89c77f-9f0a-497a-bb24-c41d21b37478) |
+| `api` | Backend API | 9876 | [API Reference](/doc/b174143d-f906-4f8d-8cb5-9fc96512e575) |
+| `docknode` | Remote Agent | 4000 | [Apps overview](/doc/fb89c77f-9f0a-497a-bb24-c41d21b37478) |
+| `dockstore` | Plugin Registry | — | [Apps overview](/doc/fb89c77f-9f0a-497a-bb24-c41d21b37478) |
+
+## Packages
+
+| Package | Description |
+|----|----|
+| [@dockstat/sqlite-wrapper](/doc/f543683b-68be-431f-a6d5-7b4012b1345a) | Type-safe SQLite query builder |
+| [@dockstat/docker-client](/doc/ef12194c-404e-4bcd-a5b0-31aaf7b1b798) | Docker operations with monitoring |
+| [@dockstat/db](/doc/5176f3ba-1242-4c85-8290-491dcc0f9963) | Database layer with themes |
+| [@dockstat/plugin-handler](/doc/eadaaa93-6c65-4207-a4ac-9b19afc8f2a5) | Plugin lifecycle management |
+| [@dockstat/logger](/doc/e913e6bd-3f7c-485f-812d-3e626b4f6b5b) | Colorized logging utility |
+| [@dockstat/typings](/doc/ecb9e07b-37e7-430a-b3fc-eb51515ab9ac) | Shared TypeScript types |
+| [@dockstat/ui](/doc/a04555b5-b827-4441-ae20-9cad1a2be714) | React UI components |
+| [@dockstat/utils](/doc/d3039895-f53c-46ab-89ce-de0ad22ce03c) | Common utilities |
+
+## Environment Variables
+
+### API (`apps/api`)
+
+| Variable | Description | Default |
+|----|----|----|
+| `DOCKSTAT_MAX_WORKERS` | Max worker threads for DockerClientManager | `200` |
+| `DOCKSTATAPI_SHOW_TRACES` | Enable server timing traces | `true` |
+| `DOCKSTATAPI_DEFAULT_PLUGIN_DIR` | Default plugin directory | `src/plugins/default-plugins` |
+
+### Logger (`packages/logger`)
+
+| Variable | Description |
+|----|----|
+| `DOCKSTAT_LOGGER_FULL_FILE_PATH` | Show full file paths in logs |
+| `DOCKSTAT_LOGGER_IGNORE_MESSAGES` | Comma-separated messages to ignore |
+| `DOCKSTAT_LOGGER_DISABLED_LOGGERS` | Comma-separated logger names to disable |
+| `DOCKSTAT_LOGGER_ONLY_SHOW` | Only show these loggers (comma-separated) |
+| `DOCKSTAT_LOGGER_SEPERATOR` | Logger name separator (default `:`) |
+
+### DockNode (`apps/docknode`)
+
+| Variable | Description |
+|----|----|
+| `DOCKNODE_DOCKSTACK_AUTH_PSK` | Production pre-shared key |
+| `DOCKNODE_DOCKSTACK_DEV_AUTH` | Development auth key |
+| `DOCKNODE_DOCKSTACK_AUTH_PRIORITY` | Auth method priority |
+| `PORT` | Server port (default `4000`) |
+
+[Full Configuration Documentation →](./configuration)
+
+## Build for Production
+
+Frontend:
+
+```bash
+cd apps/dockstat
+
+bun run build
+
+bun run start
+```
+
+The frontend Dockerfile at `apps/dockstat/Dockerfile` produces a production image.
+
+## Tech Stack
+
+| Layer | Technology |
+|----|----|
+| Runtime | Bun |
+| Backend Framework | Elysia |
+| Frontend Framework | React Router v7 (SSR) |
+| Database | SQLite (via `@dockstat/sqlite-wrapper`) |
+| Docker Integration | Dockerode (via `@dockstat/docker-client`) |
+| UI Styling | TailwindCSS |
+| Type Safety | TypeScript + Typebox schemas |
+
+## Key Features
+
+* **Multi-Host Docker Management**: Manage multiple Docker hosts from a single interface
+* **Real-Time Monitoring**: Live container statistics and event streaming
+* **Plugin System**: Extensible plugin architecture for custom functionality
+* **Theme Support**: CSS variable-based theming system
+* **Type Safety**: End-to-end TypeScript with runtime validation
+
+## Getting Help
+
+* **Troubleshooting**: [Common issues and solutions](./troubleshooting)
+* **GitHub Issues**: [github.com/Its4Nik/DockStat/issues](https://github.com/Its4Nik/DockStat/issues)
+* **Wiki**: [outline.itsnik.de](https://outline.itsnik.de/s/9d88c471-373e-4ef2-a955-b1058eb7dc99)
+
+## Contributing
+
+Contributions, ideas and bug reports are welcome. See the main repository README for contribution guidelines.