feat(screenshots): replace ai mockups with real application screenshots and publish doc bundle

.gitea/workflows/ci.yaml

@@ -18,3 +18,27 @@ jobs:
           echo "Validating documentation markdown syntax..."
           find docs -name "*.md" -print0 | xargs -0 -n 1 echo "Checked:"
           echo "All documentation files valid."
+
+      - name: Publish Documentation Bundle to Gitea Packages
+        run: |
+          tar -czf naxos-docs-bundle.tar.gz README.md docs
+          echo "Packaging naxos-docs-bundle.tar.gz to Gitea Packages registry..."
+          TOKEN="${{ secrets.PACKAGE_TOKEN }}"
+          if [ -z "$TOKEN" ]; then
+            TOKEN="${{ secrets.GITEA_TOKEN }}"
+          fi
+          RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" -X PUT \
+            -H "Authorization: token ${TOKEN}" \
+            --upload-file naxos-docs-bundle.tar.gz \
+            "${{ github.server_url }}/api/packages/naxos/generic/naxos-docs/1.0.0/naxos-docs-bundle.tar.gz")
+          STATUS=$(echo "$RESPONSE" | grep "HTTP_STATUS:" | cut -d: -f2)
+          BODY=$(echo "$RESPONSE" | grep -v "HTTP_STATUS:")
+          echo "Package upload HTTP status: $STATUS"
+          if [ "$STATUS" -eq 201 ] || [ "$STATUS" -eq 200 ] || [ "$STATUS" -eq 204 ]; then
+            echo "Successfully published naxos-docs-bundle.tar.gz to Gitea Packages!"
+          elif [ "$STATUS" -eq 409 ]; then
+            echo "Package version 1.0.0 already published in Gitea Packages: $BODY"
+          else
+            echo "Failed to publish package to Gitea Packages ($STATUS): $BODY"
+            exit 1
+          fi

README.md

@@ -11,22 +11,27 @@ Welcome to the comprehensive documentation repository for **NaxOS**, the declara
 ### 1. Dashboard Overview
 Sleek glassmorphism interface featuring circular storage capacity gauges, real-time ZFS ARC cache telemetry, active workloads, and safe declarative system rebuild triggers.
 
-![NaxOS Dashboard Overview](docs/images/dashboard-overview.jpg)
+![NaxOS Dashboard Overview](docs/images/dashboard-overview.png)
 
-### 2. OpenZFS Storage Management & Foreign Pool Migration Wizard
+### 2. OpenZFS Storage Management
-Declarative OpenZFS pool topology browser, dataset quota manager, snapshot timeline rollback, and the zero-data-loss **Foreign Pool Migration Wizard** (safely importing TrueNAS or `nixos-lukas` pools while preserving Immich photo libraries in `tank/media/photos`).
+Declarative OpenZFS pool topology browser, dataset quota manager, snapshot timeline rollback, and pool health monitoring.
 
-![NaxOS Storage Management](docs/images/storage-management.jpg)
+![NaxOS Storage Management](docs/images/storage-management.png)
 
-### 3. Embedded CNCF Perses Native Analytics
+### 3. Foreign Pool Migration Wizard
+Zero-data-loss **Appliance Setup & Migration Wizard** safely detecting and importing foreign pools from TrueNAS or `nixos-lukas` while preserving Immich photo libraries in `tank/media/photos`.
+
+![NaxOS Migration Wizard](docs/images/migration-wizard.png)
+
+### 4. Embedded CNCF Perses Native Analytics
 CNCF Perses embedded dashboards replacing standalone Grafana for real-time ZFS ARC hit ratios (98.6%), IOPS latency, 10GbE network traffic with BBR congestion control, and CPU distribution.
 
-![NaxOS Perses Analytics](docs/images/perses-analytics.jpg)
+![NaxOS Perses Analytics](docs/images/perses-analytics.png)
 
-### 4. App Store & Tri-Tier Workload Runtime Engine
+### 5. App Store & Tri-Tier Workload Runtime Engine
 Curated 1-click self-hosted application catalog with hardware-accelerated Immich (Intel QuickSync QSV / OpenCL), Nextcloud, Jellyfin, and Vaultwarden. Supports runtime toggling between **Native Systemd**, **Rootless Docker**, and **K3s**.
 
-![NaxOS App Store](docs/images/app-store.jpg)
+![NaxOS App Store](docs/images/app-store.png)
 
 ---
 

docs/architecture/app-engine.md

@@ -2,7 +2,7 @@
 
 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)
+![NaxOS App Store & Workload Runtimes](../images/app-store.png)
 
 ## 1. Native NixOS Systemd Services
 - **Best For**: High-throughput services requiring direct hardware device passthrough, minimal RAM overhead, and deep integration with OpenZFS.

docs/architecture/overview.md

@@ -13,7 +13,7 @@ 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)
+![NaxOS Web Dashboard Overview](../images/dashboard-overview.png)
 
 ---
 

docs/architecture/perses-analytics.md

@@ -15,4 +15,4 @@ NaxOS takes a pioneering approach by integrating **Perses** (a Cloud Native Comp
 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)
+![Embedded CNCF Perses Analytics](../images/perses-analytics.png)

docs/architecture/storage-engine.md

@@ -4,7 +4,7 @@
 
 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)
+![NaxOS OpenZFS Storage Management](../images/storage-management.png)
 
 ### 1. Default Pool Parameters
 When creating pools through NaxOS, the engine enforces optimal pool attributes:

docs/guides/migration-from-nixos-lukas.md

@@ -60,7 +60,7 @@ Before shutting down or booting the NaxOS installer on the NAS machine:
    - `-N` imports the pool **without mounting**, allowing NaxOS to audit and map dataset mountpoints safely.
 6. The pool and all sub-datasets (`tank/media/photos`, `tank/backup`, etc.) will appear under **Active Datasets**.
 
-![NaxOS Pool Migration Wizard and Dataset Browser](../images/storage-management.jpg)
+![NaxOS Pool Migration Wizard and Dataset Browser](../images/migration-wizard.png)
 
 ---