Skip to content

Purpose-driven docs IA and wallet module chooser

Created by: ihsraham

Summary

This PR reorganizes the WDK docs navigation around builder intent while preserving the existing reference pages and URLs. It also adds a wallet module chooser so users can start from chain/account-model intent instead of package names.

Exact deliverables

  • Reworked src/lib/custom-tree.ts into a purpose-driven docs tree:
    • Overview
    • Start Building
    • Foundation
    • Wallets
    • Swap and Bridge
    • Lending
    • On-ramp and Off-ramp
    • AI
    • React Native
    • UI Kits
    • Tools and Infrastructure
    • Partners and Contributors
    • Resources
  • Added Which wallet module do I need? at /sdk/wallet-modules/which-wallet-module.
  • Added the WalletModuleChooser MDX component with:
    • chain filter
    • wallet/account-model filter
    • WDK orange #FF6600 active state
    • default/reset state set to EVM + Standard wallet
    • links to module docs and API reference pages
  • Kept /sdk/wallet-modules as the package-oriented wallet reference list.
  • Added lightweight docs and API reference pages for:
    • RGB wallet module
    • Cosmos wallet module
  • Updated the community module catalog and all-modules catalog for RGB/Cosmos visibility.
  • Reframed package-led overview copy into concise builder-intent descriptions across wallet, core, fiat, swap, bridge, and lending overview pages.
  • Kept current swap, bridge, lending, and fiat reference index pages in the nav; no new protocol chooser pages in this pass.
  • Clarified provider failover docs to use the current @tetherto/wdk-failover-provider package and removed the legacy failover wrapper package from public docs.
  • Clarified EVM transactionMaxFee docs so provider-backed signTransaction() checks are not presented as offline signing checks.
  • Ignored generated public/api/ output so local search-index generation does not dirty the tree.
  • Preserved the new CoinGecko pricing module docs from develop under Fetch token prices.
  • Absorbed the June release docs update from #182 so release docs and IA changes share one approval path.
  • Added June 18-19 release coverage for wdk-core, wdk-wallet, wallet-solana, wallet-spark, wallet-tron-gasfree, and wdk-utils.
  • Added June 23-25 release coverage for wallet-btc, wallet-evm, wallet-ton, wallet-tron, and wallet-spark latest releases.

Final tree kept

WDK Docs

├── Overview
│   ├── Welcome
│   ├── About WDK
│   ├── Our Vision
│   ├── Partner with WDK
│   └── Showcase

├── Start Building
│   ├── Node.js and Bare Quickstart
│   ├── React Native Quickstart
│   └── React Native Starter

├── Foundation
│   ├── Understand WDK architecture
│   ├── Core SDK
│   └── All modules reference

├── Wallets
│   ├── Which wallet module do I need?
│   ├── Wallet module reference
│   ├── EVM
│   ├── Bitcoin
│   ├── Lightning (Spark)
│   ├── TON
│   ├── TRON
│   ├── Solana
│   ├── RGB
│   └── Cosmos

├── Swap and Bridge
│   ├── Swap module reference
│   ├── Velora
│   ├── Bridge module reference
│   └── USDT0 bridge

├── Lending
│   ├── Lending module reference
│   ├── Aave
│   └── Morpho

├── On-ramp and Off-ramp
│   ├── Fiat module reference
│   └── MoonPay

├── AI
│   ├── Build with AI
│   ├── MCP Toolkit
│   ├── Agent Skills
│   ├── OpenClaw
│   └── x402

├── React Native
│   ├── React Native Core
│   └── React Native Secure Storage

├── UI Kits
│   └── React Native UI Kit

├── Tools and Infrastructure
│   ├── Track balances and transactions
│   ├── Manage wallet secrets safely
│   ├── Fetch token prices
│   │   ├── Pricing module reference
│   │   └── CoinGecko HTTP
│   ├── Add provider failover
│   ├── Validate addresses and parse payment links
│   ├── Run WDK in a Pear worklet
│   └── Bundle WDK for a Bare worklet

├── Partners and Contributors
│   └── Contribute a module to WDK

└── Resources
    ├── Concepts
    ├── Get Support
    ├── Community Showcase
    └── Changelog

Wallet module chooser flow GIF

Wallet module chooser flow

Validation

  • WDK_RELEASE_MONITOR_NPM_REGISTRY=https://registry.npmjs.org node /Users/maharshimishra/Documents/wdk-docs-fork/.agent/skills/wdk-release-monitor/bin/wdk-release-monitor.mjs
  • git diff --check upstream/develop...HEAD
  • PATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" npm run check:meta
  • PATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" npm run check:redirects
  • PATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" LINK_CHECK_EXTERNAL=false npm run check:links
  • PATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" npm run build

Notes:

  • Build completed and found 0 broken links. It still prints existing docType warnings on older guide pages; this PR does not introduce those warnings.
  • Release monitor reports no published releases newer than the changelog baseline and no missing @tetherto WDK npm packages.
  • The ignored local release-monitor baseline was refreshed so the legacy failover package is marked as legacy/no visible repo and backup-cloud-react-native is tracked as npm-visible with a release/tag mismatch.

Merge request reports