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.tsinto 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
WalletModuleChooserMDX component with:- chain filter
- wallet/account-model filter
- WDK orange
#FF6600active state - default/reset state set to
EVM + Standard wallet - links to module docs and API reference pages
- Kept
/sdk/wallet-modulesas 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-providerpackage and removed the legacy failover wrapper package from public docs. - Clarified EVM
transactionMaxFeedocs so provider-backedsignTransaction()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
developunderFetch 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, andwdk-utils. - Added June 23-25 release coverage for
wallet-btc,wallet-evm,wallet-ton,wallet-tron, andwallet-sparklatest 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
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.mjsgit diff --check upstream/develop...HEADPATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" npm run check:metaPATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" npm run check:redirectsPATH="/opt/homebrew/Cellar/node@22/22.22.2_1/bin:$PATH" LINK_CHECK_EXTERNAL=false npm run check:linksPATH="/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
docTypewarnings 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
@tethertoWDK 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-nativeis tracked as npm-visible with a release/tag mismatch.