feat(screenshots): add real application screenshots to README and update package publishing

.gitea/workflows/ci.yaml

@@ -39,10 +39,25 @@ jobs:
           npm pack
           TGZ_FILE=$(ls naxos-api-*.tgz | head -n 1)
           echo "Packaging $TGZ_FILE to Gitea Packages registry..."
-          curl -s --fail-with-body -X PUT \
-            -H "Authorization: token ${{ secrets.GITEA_TOKEN }}" \
+          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 "$TGZ_FILE" \
-            "${{ github.server_url }}/api/packages/naxos/generic/naxos-api/1.0.0/$TGZ_FILE" || echo "Generic package uploaded or exists"
+            "${{ github.server_url }}/api/packages/naxos/generic/naxos-api/1.0.0/$TGZ_FILE")
+          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 $TGZ_FILE 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
 
-          echo "//git.lholz.de/api/packages/naxos/npm/:_authToken=${{ secrets.GITEA_TOKEN }}" >> ~/.npmrc
-          npm publish || echo "NPM package published or exists"
+          echo "//git.lholz.de/api/packages/naxos/npm/:_authToken=${TOKEN}" >> ~/.npmrc
+          npm publish || echo "NPM package published or exists in registry"

README.md

@@ -4,6 +4,14 @@
 
 The **NaxOS Management Daemon** serves as the core orchestration brain of the NaxOS storage appliance. It bridges web dashboard interactions with underlying declarative NixOS module generation, OpenZFS primitives, GitOps synchronization, and workload lifecycle controls.
 
+## Appliance Interface Showcase
+
+| Overview & Telemetry | OpenZFS Storage Engine |
+| :---: | :---: |
+| ![Dashboard Overview](docs/images/dashboard-overview.png) | ![Storage Management](docs/images/storage-management.png) |
+| **CNCF Perses Analytics** | **App Store & Runtimes** |
+| ![Perses Analytics](docs/images/perses-analytics.png) | ![App Store](docs/images/app-store.png) |
+
 ## Core Capabilities
 
 - **Declarative NixOS Compiler**: Translates REST API actions directly into standard NixOS module syntax (`generated-naxos-config.nix`), validated before activating via `nixos-rebuild switch`.