feat(docs): live ecosystem diagram, collapsible sidebar

knowledge/_claude-context/context.md

@@ -1,7 +1,7 @@
 # OpenIAP Project Context
 
 > **Auto-generated for Claude Code**
-> Last updated: 2026-08-11T08:49:51.526Z
+> Last updated: 2026-08-12T06:58:01.676Z
 >
 > Usage: `claude --context knowledge/_claude-context/context.md`
 
@@ -2545,8 +2545,10 @@ from OpenIAP 3.0, `react-native-iap` 16.0.0, `expo-iap` 5.0.0,
   redirects may name removed surfaces when they clearly describe history or
   route readers to the replacement.
 - The public migration catalog remains
-  `/docs/updates/deprecations`. It records the removed-to-replacement mapping
-  and the exact package major boundary.
+  `/docs/updates/migration` (published at `/docs/updates/deprecations` until
+  2026-08; that path still redirects). It is organized as one section per
+  coordinated major train, and each train records the removed-to-replacement
+  mapping and the exact package major boundary.
 - A future deprecation must be introduced through the canonical GraphQL
   deprecation directives or an explicit package-local notice, name one future
   major boundary, include a canonical replacement, and update the migration

knowledge/internal/07-docs-consistency.md

@@ -287,8 +287,10 @@ from OpenIAP 3.0, `react-native-iap` 16.0.0, `expo-iap` 5.0.0,
   redirects may name removed surfaces when they clearly describe history or
   route readers to the replacement.
 - The public migration catalog remains
-  `/docs/updates/deprecations`. It records the removed-to-replacement mapping
-  and the exact package major boundary.
+  `/docs/updates/migration` (published at `/docs/updates/deprecations` until
+  2026-08; that path still redirects). It is organized as one section per
+  coordinated major train, and each train records the removed-to-replacement
+  mapping and the exact package major boundary.
 - A future deprecation must be introduced through the canonical GraphQL
   deprecation directives or an explicit package-local notice, name one future
   major boundary, include a canonical replacement, and update the migration

libraries/expo-iap/README.md

@@ -9,7 +9,7 @@ Expo IAP is a powerful in-app purchase solution for Expo and React Native applic
 
 If you're shipping an app with expo-iap, we’d love to hear about it—please share your product and feedback in [expo-iap Q&A Discussions](https://github.com/hyodotdev/openiap/discussions/categories/expo-iap). Community stories help us keep improving the ecosystem.
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="Open IAP" height="40" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="Open IAP" height="40" /></a>
 
 </div>
 
@@ -64,7 +64,7 @@ For detailed usage examples and error handling, see the [documentation](https://
 
 ## Powered by OpenIAP
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="OpenIAP" height="50" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="OpenIAP" height="50" /></a>
 
 Expo IAP conforms to the **[OpenIAP specification](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
 

libraries/expo-iap/example/amazon.sdktester.json

@@ -4,28 +4,28 @@
     "price": 0.99,
     "title": "10 Bulbs",
     "description": "A small pack of bulbs for testing consumable purchases",
-    "smallIconUrl": "https://openiap.dev/img/logo.png"
+    "smallIconUrl": "https://openiap.dev/logo.webp"
   },
   "dev.hyo.martie.30bulbs": {
     "itemType": "CONSUMABLE",
     "price": 1.99,
     "title": "30 Bulbs",
     "description": "A larger pack of bulbs for testing consumable purchases",
-    "smallIconUrl": "https://openiap.dev/img/logo.png"
+    "smallIconUrl": "https://openiap.dev/logo.webp"
   },
   "dev.hyo.martie.certified": {
     "itemType": "ENTITLED",
     "price": 4.99,
     "title": "Certified",
     "description": "A non-consumable entitlement for OpenIAP example testing",
-    "smallIconUrl": "https://openiap.dev/img/logo.png"
+    "smallIconUrl": "https://openiap.dev/logo.webp"
   },
   "dev.hyo.martie.premium": {
     "itemType": "SUBSCRIPTION",
     "price": 4.99,
     "title": "Premium Monthly",
     "description": "Monthly premium access for OpenIAP example testing",
-    "smallIconUrl": "https://openiap.dev/img/logo.png",
+    "smallIconUrl": "https://openiap.dev/logo.webp",
     "subscriptionBase": "dev.hyo.martie.premium.base",
     "subscriptionParent": "dev.hyo.martie.premium.parent",
     "term": "Monthly"
@@ -35,7 +35,7 @@
     "price": 49.99,
     "title": "Premium Yearly",
     "description": "Yearly premium access for OpenIAP example testing",
-    "smallIconUrl": "https://openiap.dev/img/logo.png",
+    "smallIconUrl": "https://openiap.dev/logo.webp",
     "subscriptionBase": "dev.hyo.martie.premium.base",
     "subscriptionParent": "dev.hyo.martie.premium.parent",
     "term": "Yearly"

libraries/flutter_inapp_purchase/README.md

@@ -7,7 +7,7 @@
 
   A comprehensive Flutter plugin for implementing in-app purchases that conforms to the [Open IAP specification](https://openiap.dev)
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="Open IAP" height="40" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="Open IAP" height="40" /></a>
 
 </div>
 
@@ -103,7 +103,7 @@ final sameIap = FlutterInappPurchase.instance; // Same instance
 
 ## Powered by OpenIAP
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="OpenIAP" height="50" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="OpenIAP" height="50" /></a>
 
 flutter_inapp_purchase conforms to the **[OpenIAP specification](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
 

libraries/godot-iap/README.md

@@ -13,7 +13,7 @@ A comprehensive in-app purchase plugin for Godot 4.x that conforms to the <a hre
 
 Requires Godot 4.3+, iOS 17+ for the Swift GDExtension, or Android API 24+.
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="Open IAP" height="40" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="Open IAP" height="40" /></a>
 
 </div>
 
@@ -80,7 +80,7 @@ See the [Quick Start Guide](https://openiap.dev/docs/setup/godot) for complete c
 
 ## Powered by OpenIAP
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="OpenIAP" height="50" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="OpenIAP" height="50" /></a>
 
 godot-iap conforms to the **[OpenIAP specification](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
 

libraries/kmp-iap/README.md

@@ -1,7 +1,7 @@
 # kmp-iap
 
 <div align="center">
-  <img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/libraries/kmp-iap/docs/static/img/logo.png" width="200" alt="kmp-iap logo" />
+  <img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/packages/docs/public/logos/kmp-iap.webp" width="200" alt="kmp-iap logo" />
 
   <a href="https://central.sonatype.com/artifact/io.github.hyochan/kmp-iap"><img src="https://img.shields.io/maven-central/v/io.github.hyochan/kmp-iap.svg?style=flat-square" alt="Maven Central" /></a>
   <a href="https://github.com/hyodotdev/openiap/actions/workflows/ci-kmp-iap.yml?query=branch%3Amain"><img src="https://github.com/hyodotdev/openiap/actions/workflows/ci-kmp-iap.yml/badge.svg?branch=main" alt="KMP CI" /></a>
@@ -10,7 +10,7 @@
 
   A comprehensive Kotlin Multiplatform library for in-app purchases on Android and iOS platforms that conforms to the <a href="https://openiap.dev">Open IAP specification</a>
 
-  <a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="Open IAP" height="40" /></a>
+  <a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="Open IAP" height="40" /></a>
 </div>
 
 ## 📚 Documentation
@@ -127,7 +127,7 @@ kmpIAP.finishTransaction(
 
 ## Powered by OpenIAP
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="OpenIAP" height="50" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="OpenIAP" height="50" /></a>
 
 kmp-iap conforms to the **[OpenIAP specification](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
 

libraries/react-native-iap/README.md

@@ -7,7 +7,7 @@
 
 **React Native IAP** is a high-performance in-app purchase library using Nitro Modules that **conforms to the [Open IAP specification](https://openiap.dev)**. It provides a unified API for handling in-app purchases across iOS and Android platforms with comprehensive error handling and modern TypeScript support.
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="Open IAP" height="40" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="Open IAP" height="40" /></a>
 </div>
 
 ## 📚 Documentation
@@ -137,7 +137,7 @@ Quick links:
 
 ## Powered by OpenIAP
 
-<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.png" alt="OpenIAP" height="50" /></a>
+<a href="https://openiap.dev"><img src="https://raw.githubusercontent.com/hyodotdev/openiap/main/logo.webp" alt="OpenIAP" height="50" /></a>
 
 React Native IAP conforms to the **[OpenIAP specification](https://openiap.dev)** — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:
 

libraries/react-native-iap/example/amazon.sdktester.json

@@ -4,28 +4,28 @@
     "price": 0.99,
     "title": "10 Bulbs",
     "description": "A small pack of bulbs for testing consumable purchases",
-    "smallIconUrl": "https://openiap.dev/img/logo.png"
+    "smallIconUrl": "https://openiap.dev/logo.webp"
   },
   "dev.hyo.martie.30bulbs": {
     "itemType": "CONSUMABLE",
     "price": 1.99,
     "title": "30 Bulbs",
     "description": "A larger pack of bulbs for testing consumable purchases",
-    "smallIconUrl": "https://openiap.dev/img/logo.png"
+    "smallIconUrl": "https://openiap.dev/logo.webp"
   },
   "dev.hyo.martie.certified": {
     "itemType": "ENTITLED",
     "price": 4.99,
     "title": "Certified",
     "description": "A non-consumable entitlement for OpenIAP example testing",
-    "smallIconUrl": "https://openiap.dev/img/logo.png"
+    "smallIconUrl": "https://openiap.dev/logo.webp"
   },
   "dev.hyo.martie.premium": {
     "itemType": "SUBSCRIPTION",
     "price": 4.99,
     "title": "Premium Monthly",
     "description": "Monthly premium access for OpenIAP example testing",
-    "smallIconUrl": "https://openiap.dev/img/logo.png",
+    "smallIconUrl": "https://openiap.dev/logo.webp",
     "subscriptionBase": "dev.hyo.martie.premium.base",
     "subscriptionParent": "dev.hyo.martie.premium.parent",
     "term": "Monthly"
@@ -35,7 +35,7 @@
     "price": 49.99,
     "title": "Premium Yearly",
     "description": "Yearly premium access for OpenIAP example testing",
-    "smallIconUrl": "https://openiap.dev/img/logo.png",
+    "smallIconUrl": "https://openiap.dev/logo.webp",
     "subscriptionBase": "dev.hyo.martie.premium.base",
     "subscriptionParent": "dev.hyo.martie.premium.parent",
     "term": "Yearly"

packages/docs/public/llms-full.txt

@@ -2245,7 +2245,7 @@ assuming DAU implies safe request volume.
   replacement, generated warnings where supported, migration documentation,
   and executable absence checks at the removal boundary. Patch and minor
   releases must not remove them early.
-- See https://openiap.dev/docs/updates/deprecations for the complete mapping.
+- See https://openiap.dev/docs/updates/migration for the complete mapping.
 
 ---
 

packages/docs/public/llms.txt

@@ -84,7 +84,7 @@ Current NuGet package version: 2.3.0
   replacement, generated warnings where supported, migration documentation,
   and executable absence checks at the removal boundary. Patch and minor
   releases must not remove them early.
-- See https://openiap.dev/docs/updates/deprecations for the complete mapping.
+- See https://openiap.dev/docs/updates/migration for the complete mapping.
 
 
 ## Core APIs

packages/docs/public/sitemap.xml

@@ -158,7 +158,7 @@
     <priority>0.7</priority>
   </url>
   <url>
-    <loc>https://openiap.dev/docs/updates/deprecations</loc>
+    <loc>https://openiap.dev/docs/updates/migration</loc>
     <lastmod>2026-07-24</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>

packages/docs/scripts/render-mcp-demo-video.mjs

@@ -31,9 +31,9 @@ const outputPath = resolve(
 );
 const purchaseCapturePath = resolve(
   scriptDir,
-  '../public/docs/images/openiap-mcp-iphone-purchase.png'
+  '../public/docs/images/openiap-mcp-iphone-purchase.webp'
 );
-const purchaseCaptureDataUri = `data:image/png;base64,${readFileSync(
+const purchaseCaptureDataUri = `data:image/webp;base64,${readFileSync(
   purchaseCapturePath
 ).toString('base64')}`;