README, docs: add one-line setup+install, document required apt update step

Author: ra-yavuz

README.md

@@ -79,19 +79,41 @@ meowtrics --help
 
 ## Install via apt repository (recommended for Debian / Ubuntu)
 
+One line. Sets up the signed apt repo if not already added, refreshes the package index, and installs meowtrics. Idempotent, safe to re-run:
+
+```bash
+sudo bash -c 'set -e; install -m 0755 -d /etc/apt/keyrings && curl -fsSL https://ra-yavuz.github.io/apt/pubkey.gpg -o /etc/apt/keyrings/ra-yavuz.gpg && echo "deb [signed-by=/etc/apt/keyrings/ra-yavuz.gpg] https://ra-yavuz.github.io/apt stable main" > /etc/apt/sources.list.d/ra-yavuz.list && apt update && apt install -y meowtrics'
+systemctl --user enable --now meowtrics
+```
+
+If you already added the `ra-yavuz` apt repo earlier, all you need is:
+
 ```bash
+sudo apt update && sudo apt install meowtrics
+```
+
+The `sudo apt update` step is required: without it apt will not see new packages or new versions.
+
+<details><summary>Step by step (manual repo setup)</summary>
+
+```bash
+# 1. Trust the signing key
 sudo install -m 0755 -d /etc/apt/keyrings
 curl -fsSL https://ra-yavuz.github.io/apt/pubkey.gpg \
   | sudo tee /etc/apt/keyrings/ra-yavuz.gpg > /dev/null
 
+# 2. Add the apt source
 echo "deb [signed-by=/etc/apt/keyrings/ra-yavuz.gpg] https://ra-yavuz.github.io/apt stable main" \
   | sudo tee /etc/apt/sources.list.d/ra-yavuz.list
 
+# 3. Refresh the package index, then install
 sudo apt update
 sudo apt install meowtrics
 systemctl --user enable --now meowtrics
 ```
 
+</details>
+
 ## Install single `.deb` from GitHub Releases
 
 No automatic updates with this path.

docs/index.html

@@ -258,23 +258,38 @@ <h2 id="messages">Messages</h2>
     More cats, funnier lines, more nuanced states.
   </p>
 
-  <h2>Install via apt repository</h2>
+  <h2 id="install-quick">Install via apt repository</h2>
   <section class="apt-section">
     <p>
-      Add the
+      One line. Sets up the
       <a href="https://ra-yavuz.github.io/apt/">ra-yavuz apt repository</a>
-      and install with apt. Auto-updates via <code>apt upgrade</code>.
+      if not already added, refreshes the package index, and installs meowtrics.
+      Idempotent, safe to re-run. Auto-updates via <code>apt upgrade</code>.
     </p>
-    <pre><code>sudo install -m 0755 -d /etc/apt/keyrings
+    <pre><code>sudo bash -c 'set -e; install -m 0755 -d /etc/apt/keyrings &amp;&amp; curl -fsSL https://ra-yavuz.github.io/apt/pubkey.gpg -o /etc/apt/keyrings/ra-yavuz.gpg &amp;&amp; echo "deb [signed-by=/etc/apt/keyrings/ra-yavuz.gpg] https://ra-yavuz.github.io/apt stable main" &gt; /etc/apt/sources.list.d/ra-yavuz.list &amp;&amp; apt update &amp;&amp; apt install -y meowtrics'
+systemctl --user enable --now meowtrics</code></pre>
+    <p style="opacity: 0.85;">
+      If you already added the <code>ra-yavuz</code> apt repo earlier, all you need is
+      <code>sudo apt update &amp;&amp; sudo apt install meowtrics</code>. The
+      <code>sudo apt update</code> step is required: without it apt will not see new
+      packages or new versions.
+    </p>
+    <details>
+      <summary>Step by step (manual repo setup)</summary>
+      <pre><code># 1. Trust the signing key
+sudo install -m 0755 -d /etc/apt/keyrings
 curl -fsSL https://ra-yavuz.github.io/apt/pubkey.gpg \
   | sudo tee /etc/apt/keyrings/ra-yavuz.gpg > /dev/null
 
+# 2. Add the apt source
 echo "deb [signed-by=/etc/apt/keyrings/ra-yavuz.gpg] https://ra-yavuz.github.io/apt stable main" \
   | sudo tee /etc/apt/sources.list.d/ra-yavuz.list
 
+# 3. Refresh the package index, then install
 sudo apt update
 sudo apt install meowtrics
 systemctl --user enable --now meowtrics</code></pre>
+    </details>
   </section>
 
   <h2>Install single .deb from GitHub Releases</h2>