docs: add project lockup hero to home page

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: lesnik512

docs/assets/lockup-dark.svg

@@ -15,3 +15,23 @@
   --md-accent-fg-color:         #e0a300;
   --md-typeset-a-color:         #7fb79f;
 }
+
+/* Centered project lockup hero on the docs home page */
+.mp-hero {
+  text-align: center;
+  margin: 1.5rem 0 2.5rem;
+}
+.mp-hero .mp-lockup {
+  margin: 0;
+  font-size: 0;   /* collapse whitespace between the stacked <img> variants */
+  line-height: 0;
+}
+.mp-hero .mp-logo {
+  max-width: 420px;
+  width: 70%;
+  height: auto;
+}
+/* Light lockup by default; cream lockup in dark (slate) mode. */
+.mp-hero .mp-logo--dark { display: none; }
+[data-md-color-scheme="slate"] .mp-hero .mp-logo--light { display: none; }
+[data-md-color-scheme="slate"] .mp-hero .mp-logo--dark  { display: inline; }

docs/assets/lockup-light.svg

@@ -1,4 +1,11 @@
-# httpware
+<div class="mp-hero" markdown>
+
+<h1 class="mp-lockup">
+<img class="mp-logo mp-logo--light" src="assets/lockup-light.svg" alt="httpware">
+<img class="mp-logo mp-logo--dark" src="assets/lockup-dark.svg" alt="" aria-hidden="true">
+</h1>
+
+</div>
 
 A Python HTTP client framework with sync and async clients for building resilient service clients. `httpware` is a thin opinionated wrapper around `httpx2` — it re-exports `httpx2.Request`/`httpx2.Response` as the public request/response surface, adds a middleware chain (with a built-in resilience suite: `AsyncRetry`/`Retry` + `RetryBudget`, `AsyncBulkhead`/`Bulkhead`, `AsyncCircuitBreaker`/`CircuitBreaker`, and `AsyncTimeout`), opt-in typed response decoding, and a status-keyed exception tree raised automatically on 4xx/5xx.