docs: theme-aware GIFs via picture element

README.md

@@ -6,7 +6,11 @@
 [![PyPI](https://img.shields.io/pypi/v/platecli)](https://pypi.org/project/platecli/)
 [![Downloads](https://static.pepy.tech/badge/platecli)](https://pepy.tech/projects/platecli)
 
-![platecli demo: live printer status and slicing from the terminal](docs/demo.gif)
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/DLANSAMA/platecli/main/docs/demo-dark.gif">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/DLANSAMA/platecli/main/docs/demo-light.gif">
+  <img alt="platecli demo: live printer status and slicing from the terminal" src="https://raw.githubusercontent.com/DLANSAMA/platecli/main/docs/demo-dark.gif">
+</picture>
 
 Fully local 3D printing pipeline for Bambu Lab printers. Runs on **Linux, macOS, and Windows**. The installed command is `plate`. Download models from Printables, slice with OrcaSlicer, and print — all controlled via CLI by any AI agent or by hand. No cloud account needed.
 
@@ -108,7 +112,11 @@ plate config validate   # check config values without contacting the printer
 plate doctor            # connectivity + live cert fingerprint
 ```
 
-![plate doctor: config, MQTT, and FTPS health checks with TLS-pin verification against a real printer](docs/doctor.gif)
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/DLANSAMA/platecli/main/docs/doctor-dark.gif">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/DLANSAMA/platecli/main/docs/doctor-light.gif">
+  <img alt="plate doctor: config, MQTT, and FTPS health checks with TLS-pin verification against a real printer" src="https://raw.githubusercontent.com/DLANSAMA/platecli/main/docs/doctor-dark.gif">
+</picture>
 
 ### OrcaSlicer
 

docs/demo.tape → docs/demo-dark.tape

@@ -1,10 +1,10 @@
 # Demo recording for README. Regenerate from the repo root with:
-#   vhs docs/demo.tape
+#   vhs docs/demo-dark.tape
 # Requires: vhs, an installed `plate` in .venv/bin, a reachable printer
 # (status is read-only), and side-v2a.stl (or any STL) in the repo root.
 # Styling matches the repo social-preview card (dark, rounded, traffic lights).
 
-Output docs/demo.gif
+Output docs/demo-dark.gif
 
 Set Shell "bash"
 Set FontFamily "Hack"

docs/demo-light.tape

@@ -0,0 +1,35 @@
+# Demo recording for README. Regenerate from the repo root with:
+#   vhs docs/demo-light.tape
+# Requires: vhs, an installed `plate` in .venv/bin, a reachable printer
+# (status is read-only), and side-v2a.stl (or any STL) in the repo root.
+# Styling matches the repo social-preview card (dark, rounded, traffic lights).
+
+Output docs/demo-light.gif
+
+Set Shell "bash"
+Set FontFamily "Hack"
+Set FontSize 15
+Set Width 1100
+Set Height 420
+Set Padding 24
+Set Margin 36
+Set MarginFill "#f6f8fa"
+Set BorderRadius 14
+Set WindowBar Colorful
+Set WindowBarSize 44
+Set Theme { "name": "platecli-light", "background": "#ffffff", "foreground": "#1f2328", "cursor": "#0f766e", "black": "#24292f", "red": "#cf222e", "green": "#1a7f37", "yellow": "#9a6700", "blue": "#0969da", "magenta": "#8250df", "cyan": "#0f766e", "white": "#6e7781", "brightBlack": "#57606a", "brightRed": "#a40e26", "brightGreen": "#1a7f37", "brightYellow": "#bf8700", "brightBlue": "#218bff", "brightMagenta": "#a475f9", "brightCyan": "#0f766e", "brightWhite": "#1f2328" }
+
+Hide
+Type "export PATH=$PWD/.venv/bin:$PATH && clear"
+Enter
+Show
+
+Type "plate status"
+Sleep 500ms
+Enter
+Sleep 6s
+
+Type "plate slice side-v2a.stl"
+Sleep 500ms
+Enter
+Sleep 6s

docs/doctor.tape → docs/doctor-dark.tape

@@ -1,9 +1,9 @@
 # Doctor-demo recording for README (mid-page). Regenerate from the repo root:
-#   vhs docs/doctor.tape
+#   vhs docs/doctor-dark.tape
 # Requires: vhs, an installed `plate` in .venv/bin, and a reachable printer
 # (doctor is read-only). Styling matches docs/demo.tape / the social card.
 
-Output docs/doctor.gif
+Output docs/doctor-dark.gif
 
 Set Shell "bash"
 Set FontFamily "Hack"

docs/doctor-light.tape

@@ -0,0 +1,29 @@
+# Doctor-demo recording for README (mid-page). Regenerate from the repo root:
+#   vhs docs/doctor-light.tape
+# Requires: vhs, an installed `plate` in .venv/bin, and a reachable printer
+# (doctor is read-only). Styling matches docs/demo.tape / the social card.
+
+Output docs/doctor-light.gif
+
+Set Shell "bash"
+Set FontFamily "Hack"
+Set FontSize 15
+Set Width 1100
+Set Height 480
+Set Padding 24
+Set Margin 36
+Set MarginFill "#f6f8fa"
+Set BorderRadius 14
+Set WindowBar Colorful
+Set WindowBarSize 44
+Set Theme { "name": "platecli-light", "background": "#ffffff", "foreground": "#1f2328", "cursor": "#0f766e", "black": "#24292f", "red": "#cf222e", "green": "#1a7f37", "yellow": "#9a6700", "blue": "#0969da", "magenta": "#8250df", "cyan": "#0f766e", "white": "#6e7781", "brightBlack": "#57606a", "brightRed": "#a40e26", "brightGreen": "#1a7f37", "brightYellow": "#bf8700", "brightBlue": "#218bff", "brightMagenta": "#a475f9", "brightCyan": "#0f766e", "brightWhite": "#1f2328" }
+
+Hide
+Type "export PATH=$PWD/.venv/bin:$PATH && clear"
+Enter
+Show
+
+Type "plate doctor"
+Sleep 500ms
+Enter
+Sleep 9s