docs: enrich documentation and README with high-resolution application screenshots

2026-09-04 07:34:27 +02:00
parent ce7c125391
commit fcb92b0688
10 changed files with 42 additions and 6 deletions
@@ -2,6 +2,8 @@

 NaxOS features a tri-tier runtime engine that selects the best execution strategy for each application:

+![NaxOS App Store & Workload Runtimes](../images/app-store.jpg)
+
 ## 1. Native NixOS Systemd Services
 - **Best For**: High-throughput services requiring direct hardware device passthrough, minimal RAM overhead, and deep integration with OpenZFS.
 - **Example**: **Immich** Photo Hub.
@@ -13,6 +13,8 @@ NaxOS introduces an opinionated, cloud-native paradigm:
 4. **Data Safety First**: Existing OpenZFS pools from legacy systems (such as `nixos-lukas` or TrueNAS) are imported read-safe without formatting, preserving critical application storage such as Immich photo libraries.
 5. **Modern Native Observability**: Replaces heavy standalone Grafana instances with embedded CNCF **Perses** dashboards that render natively inside the web UI.

+![NaxOS Web Dashboard Overview](../images/dashboard-overview.jpg)
+
 ---

 ## Architectural Subsystems
@@ -14,3 +14,5 @@ NaxOS takes a pioneering approach by integrating **Perses** (a Cloud Native Comp
   - Eliminates Grafana's multi-megabyte bundle overhead, auth barriers, and database schema migrations.
 3. **Optimized for OpenZFS Metrics**:
   - Out-of-the-box panels monitor OpenZFS ARC hits, misses, ARC target sizing, IOPS, and disk latencies scraped from Prometheus and Node Exporter.
+
+![Embedded CNCF Perses Analytics](../images/perses-analytics.jpg)
@@ -4,6 +4,8 @@

 NaxOS leverages upstream OpenZFS on Linux with specific architectural choices optimized for mixed workloads (streaming media, small-file databases, photo indexing, and Apple Time Machine backups).

+![NaxOS OpenZFS Storage Management](../images/storage-management.jpg)
+
 ### 1. Default Pool Parameters
 When creating pools through NaxOS, the engine enforces optimal pool attributes:
 - `ashift=12`: 4096-byte sector alignment to eliminate write amplification on modern Advanced Format HDDs and NVMe SSDs.