design: rebuild landing hero as a 3D laptop

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2026-11-07 — 3D landing visuals and v1.0.4 docs
+
+- Rebuilt the hero as an interactive 3D keyboard: a procedural mechanical keyboard on a lit desk, a holographic terminal rendered to a canvas texture, keys that depress and glow on hover, and the typed characters appearing on the terminal screen in real time. The old DOM terminal is kept only as the no-WebGL fallback.
+- Reworked the home banner as a live 3D surface built from the official SVG (canvas texture) with depth particles, a subtle tilt and the original image as fallback when WebGL, CORS or the network is unavailable.
+- Replaced the isometric SVG architecture map with an interactive 3D scene: four stacked layers, glowing data-flow connectors, a WASM sandbox plane and clickable slabs that drive the existing detail panel. The SVG remains the fallback and the mobile layer list is unchanged.
+- All scenes respect `prefers-reduced-motion`, pause when offscreen, cap DPR and follow the light/dark CSS palette.
+- Docs synced with xfetch v1.0.4: all three changelogs (v1.0.2, v1.0.3, v1.0.4), a new CLI reference in English, Spanish and German, the `right` layout, addon install/update/rollback lifecycle, backup/restore, doctor and structured logging.
+- Updated the landing version, layout options, roadmap phases and the theme sample to the current registry size.
+
 ## 2026-10-24 — Security update
 
 - Updated Next.js from 16.3.1 to 16.4.3 and aligned `eslint-config-next` to 16.4.3, closing the critical Next.js advisories (including the unauthenticated RCE and cache-poisoning/SSRF reports).

README.md

@@ -9,10 +9,14 @@
 
 <ul>
   <li><a href="docs/en/getting-started.md">Getting Started</a></li>
+  <li><a href="docs/en/cli.md">CLI Reference</a></li>
   <li><a href="docs/en/configuration.md">Configuration</a></li>
   <li><a href="docs/en/layouts.md">Layouts</a></li>
   <li><a href="docs/en/modules.md">Modules</a></li>
   <li><a href="docs/en/plugins.md">Plugins</a></li>
+  <li><a href="docs/en/extensions.md">Extensions</a></li>
+  <li><a href="docs/en/effects.md">Effects</a></li>
+  <li><a href="docs/en/wasm.md">WebAssembly Guests</a></li>
   <li><a href="docs/en/themes.md">Themes</a></li>
   <li><a href="docs/en/presets.md">Presets</a></li>
   <li><a href="docs/en/advanced-usage.md">Advanced Usage</a></li>

ROADMAP.md

@@ -10,4 +10,6 @@ Status-driven roadmap for the xfetch site and its documentation.
 - [x] Plugin pages for all 12 official plugins (including chocolatey and temperature)
 - [x] Static export ready for GitHub Pages (`output: "export"`, `basePath: /web` for the org site)
 - [x] Sitemap and robots.txt; local CI (`npm run lint` + `npm run build`) via `scripts/`
+- [x] Docs synced with xfetch v1.0.4 (v1.0.2, v1.0.3 and v1.0.4 changelogs, CLI reference in three languages, `right` layout, addon lifecycle)
+- [x] Interactive 3D keyboard hero (hover-to-press keys typing into a holographic terminal), 3D banner and interactive architecture map with Three.js / React Three Fiber, with SVG and `<img>` fallbacks
 

docs/de/SUMMARY.md

@@ -2,7 +2,7 @@
 
 Ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust.
 
-- **Version:** 1.0.1
+- **Version:** 1.0.4
 - **Lizenz:** MIT
 - **Autor:** xscriptor
 - **Repository:** github.com/xfetch-cli/xfetch
@@ -169,3 +169,9 @@ Ein plattformunabhangiges Systeminformations-Tool geschrieben in Rust.
 
 20. [Lizenz](license.md)
     - MIT-Lizenzbestimmungen
+
+21. [CLI-Referenz](cli.md)
+    - Globale Optionen und Laufzeit-Overrides
+    - JSON, `--get` und Templates
+    - Addon-, Config-, Doctor- und Update-Befehle
+    - Exit-Codes, Logging und Umgebungsvariablen

docs/de/advanced-usage.md

@@ -175,6 +175,33 @@ xfetch effects remove <name>    # Effekt entfernen
 
 Siehe die Seite [Effekte](effects.md) für das vollständige Protokoll, die Konfigurationsfelder und das Schreiben eigener Effekte.
 
+## CLI-Automatisierung
+
+Die vollständige Befehlsreferenz steht in [CLI-Referenz](cli.md). Die wichtigsten Automatisierungspunkte:
+
+```bash
+# Maschinenlesbare Ausgabe
+xfetch --json
+xfetch --json --modules os,kernel,cpu
+xfetch --get os,cpu,memory
+xfetch --format '{{os}} | {{kernel}} | {{uptime}}'
+
+# Laufzeit-Overrides
+xfetch --layout right --theme dracula --no-color
+xfetch --offline --no-cache
+
+# Diagnose
+xfetch doctor --network --json
+xfetch config validate
+xfetch config set layout right
+
+# Backups
+xfetch config backup --compress
+xfetch config restore --dry-run
+```
+
+`--json` verwendet immer `schema_version: 1`. Mit `--format` unterstützen Templates `{{key}}`, die Filter `upper`/`lower`/`trim`/`count`/`join`/`default` sowie `{{#if}}`, `{{#unless}}`- und `{{#each}}`-Blöcke. `--quiet`, `--verbose` und `--log-level` steuern stderr; `--log-json` gibt JSON-Zeilen aus, damit stdout für Befehlsausgaben sauber bleibt.
+
 ## Leistungsoptimierung
 
 xfetch verwendet mehrere Leistungsoptimierungen:

docs/de/changelog.md

@@ -1,5 +1,29 @@
 # Anderungsprotokoll
-# Anderungsprotokoll
+
+## v1.0.4 · Layout-Fix für breite Zeichen · 2026-11-07
+
+- Die Layouts klassische Box, Section-Box und Side-Block messen die sichtbare Terminalbreite jetzt mit `console::measure_text_width` statt Unicode-Skalarwerte zu zählen. CJK- und Emoji-Werte (zum Beispiel aus `banner-text`) halten die rechten Ränder ohne unsichtbares Padding bündig.
+
+## v1.0.3 · CLI, JSON-Ausgabe, Backups und Command-Addons · 2026-11-06
+
+- **Maschinenlesbare Ausgabe:** `--json` (`schema_version: 1`), `--get`, `--list-modules`, der Befehl `modules` und JSON für Addon-, Theme- und Update-Abfragen.
+- **Laufzeit-Overrides:** `--layout`, `--theme`, `--modules`/`--only`, `--color`/`--no-color`, `--offline`, `--no-cache`, `--quiet`, `--verbose`, `--template` und `--format`.
+- **Diagnose und Konfiguration:** `doctor` (mit `--fix`, `--bench`, `--image`, `--network`), `config validate|print|get|set|unset|reset|edit|backups|prune`, `paths`, `env`, `build-info`, `schema`, `completions` und `man`.
+- **Backup und Wiederherstellung:** `--backup`/`--restore` und `config backup|restore` mit aktivem Theme, config-roulette-Routen, Logo-Assets, Addon-Artefakten, gzip-Kompression, Passphrase-Verschlüsselung (Argon2id + XChaCha20-Poly1305) und Root-Remapping.
+- **Addon-Lebenszyklus:** Install-Receipts (`.install.json`), `update`, `rollback` und `install --all` für Plugins, Effekte und Erweiterungen; Kataloge akzeptieren `repo`, `ref`, `sdk_version` und `min_xfetch_version`.
+- **Command-Addons:** die neue `command`-Familie und `xfetch run`, mit `--render` für die Ausgabe durch das Core-Layout, plus separater Command-Katalog.
+- **Layouts:** `layout: "right"` hinzugefügt (Info links, Logo rechts).
+- **SDK:** xfetch SDK 0.3.1 übernommen; JSON-Protokoll bleibt `1`, WIT bleibt `0.1.0`.
+- **Windows-Updater:** `xfetch update` ersetzt Prebuilt-Installationen mit `self-replace`, delegiert winget-Installationen und baut Source-Checkouts neu. `winget install xfetch` ist dokumentiert.
+- Stabile Exit-Codes, strukturiertes Logging (`--log-level`, `--log-json`), Help-/Output-Snapshots und ein CLI-Sandbox-Test wurden ergänzt.
+
+## v1.0.2 · Sicherheitsupdate, Paketzählung und Katalog-Tooling · 2026-11-03
+
+- `wasmtime`/`wasmtime-wasi` auf 50.0.1 und `zstd` auf 0.13.4 aktualisiert; die RustSec-Hinweise von 2026 sind geschlossen. Binaries aus v1.0.1 bleiben betroffen.
+- `sysinfo` 0.40 und `ureq` 3.5.1 aktualisiert, ohne sichtbare Ausgabeänderungen.
+- Die Linux-Paketzählung erhielt `xpm`, `xp` und `xpm-aur`-Labels, die lokale Datenbanken lesen und keine Remote-Kataloge abfragen.
+- `xfetch --list-layouts` hinzugefügt und die `--layout`-Hilfe korrigiert (Standard `section`).
+- Addon-Installationen zeigen das nötige Config-Snippet, Fähigkeiten und Limits; `list --verbose`, `info`, `search`/`available`, `--name`/`--manifest` für Wasm-Quellen und Befehlsaliase wurden ergänzt.
 
 ## v1.0.1 · Sicherheitsrelease: gepatchte Abhängigkeiten, signierte Releases und sicherere Installer · 2026-10-24