Skip to content

Update docs structure: new IA pillars + two-row top nav#60

Merged
derekchiang merged 6 commits into
mainfrom
update-docs-structure
May 12, 2026
Merged

Update docs structure: new IA pillars + two-row top nav#60
derekchiang merged 6 commits into
mainfrom
update-docs-structure

Conversation

@sgandhi-8
Copy link
Copy Markdown
Collaborator

Reorganizes the docs into 5 top-level pillars and adds a two-row top nav.

  • 5 pillars: Get Started · Smart Accounts & Wallets · Cross-Chain Workflows · Advanced · Resources
  • Two-row top nav: utility links + search on top, pillar tabs below
  • New SDKs subsection under Get Started with 8 stub pages (TS, iOS, Android, Node.js, Python, Rust, C + overview)
  • Deletes: /global-address/, /smart-wallet/**, and the old quickstart (tutorial is the new quickstart)

sgandhi-8 and others added 3 commits May 7, 2026 20:27
Move every docs page into one of five top-level pillars: Get Started,
Smart Accounts & Wallets, Cross-Chain Workflows, Advanced, and
Resources. Existing technical content is preserved verbatim — only
paths change.

- /sdk/{core-api,advanced,permissions,signers,solana,faqs,infra,presets,
  getting-started}/* moved into the new pillar tree.
- /wallets/** -> /smart-accounts/embedded-wallet/**
- /react/** -> /advanced/react-hooks/**
- /meta-infra/** -> /resources/infrastructure/**
- /recovery-flow/** -> /smart-accounts/account-recovery/
- /smart-routing-address/index.mdx -> /cross-chain/smart-routing-address/
- /sdk/advanced/recovery.mdx -> /smart-accounts/account-recovery/sdk-recovery
- tutorial-passkeys, quickstart-7702, quickstart-agentkit moved out of
  Get Started into their topical sections as code examples.

Deletes:
- /global-address/ (exact duplicate of Smart Routing Address).
- /smart-wallet/** (36 orphan pages duplicating /sdk/* content).
- /sdk/getting-started/quickstart (the renamed tutorial now serves as
  the single quickstart).

Internal links inside moved files are updated to reference new paths.
/sdk/v5_3_x/** is intentionally untouched as the legacy version.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- topNav reduced to utility links only (API Reference, Dashboard, Blog).
  The five pillars now render as a separate horizontal bar below the
  top header via a new inject-pillar-bar Vite plugin. The bar mounts at
  document.body so it escapes Vocs's fixed-height gutterTop, pinned via
  position:fixed under the top nav with active-state highlighting via
  aria-current and a small history-API patch for SPA navigation.
- sidebar split from a single mega-tree into six per-prefix entries:
  /, /smart-accounts, /cross-chain, /advanced, /resources, and the
  unchanged /sdk/v5_3_x. Each pillar renders only its own tree.
- Redirect map (~150 entries) added as a Vite middleware so legacy
  URLs forward to their new homes — /sdk/*, /wallets/**, /meta-infra/*,
  /recovery-flow/*, /global-address, /smart-wallet/**, and /react/**.

Plus internal-link updates across moved .mdx files (replaced /sdk/*,
/wallets/*, /meta-infra/*, /recovery-flow/*, /global-address,
/smart-wallet/*, and /react/* references with their new paths).
v5_3_x cross-pillar links also rewritten where they pointed to
relocated shared sections (meta-infra, recovery-flow, smart-wallet).
React-hooks shared-import paths bumped from ../shared/ to
../../shared/ to reflect their new directory depth.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Add a Get Started > SDKs subsection covering client-side and
server-side stacks. Each stub follows an Install / Setup / Example
template with TODO(authoring) markers and a "🚧 Coming soon" notice
for the placeholder content.

Stubs:
- /get-started/sdks/overview
- /get-started/sdks/client-side/typescript
- /get-started/sdks/client-side/ios
- /get-started/sdks/client-side/android
- /get-started/sdks/server-side/nodejs
- /get-started/sdks/server-side/python
- /get-started/sdks/server-side/rust
- /get-started/sdks/server-side/c

Three additional sidebar entries link to existing pages instead of
new stubs: React Hooks (waas) -> /advanced/react-hooks/getting-started,
Embedded Wallet (React) -> /smart-accounts/embedded-wallet/quickstart,
Go (legacy) -> /advanced/go-sdk.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Error Error May 12, 2026 4:14pm

Request Review

  - Replace long quickstart.mdx with the shorter single-file flow; move
    the dashboard project setup into a new Get Started › SDKs › "Set up
    a project" page, and the TypeScript tutorial into the TypeScript /
    JavaScript SDK page.
  - Rename the Resources pillar to "API & Toolings" (rehome
    docs/pages/resources/* under docs/pages/api-and-toolings/).
  - Promote Embedded Wallet to a top-level sidebar group alongside
    Smart Account under the Smart Accounts & Wallets pillar.
  - Expand SDKs (and Client-side / Server-side), Sponsor Gas, and
    Infrastructure / Tools by default.
  - Drop the legacy @zerodev/waas React Hooks entries from the Advanced
    pillar, the Get Started SDKs sidebar, and the SDKs overview page.
  - Point the UserOp Debugger and Status & Uptime API sidebar items at
    https://debug.zerodev.app/ and https://status.zerodev.app/.
  - Add an inject-external-link-handler Vite plugin so external <a>
    elements (sidebar and content) open in a new tab with rel=noopener.
Fills the 5 omni SDK stubs (iOS, Android, Python, Rust, C) with full
install/setup/example/custom-signers/7702-delegation/next-steps content
sourced from the omni-sdk README.

Adds a new server-side/go.mdx for the omni Go binding, and removes the
legacy /advanced/go-sdk page (sidebar entry, advanced sidebar entry, and
mdx file). Existing /advanced/go-sdk URL redirects to the new location.

Also fixes the dead-link path /resources/infrastructure/rpcs ->
/api-and-toolings/infrastructure/rpcs (was wrong in the existing stubs)
across the 7 SDK pages.

Each language page covers:
- Install: real install command + latest alpha version
- Setup: import + Context + Signer + Account
- Example: end-to-end sponsored UserOp
- Custom signers: pattern for Privy/HSM/MPC backends
- EIP-7702 delegation: newAccount7702 + auto auth signing
- Next steps: example repo + smart-account creation + RPC docs

Overview page now points to the new Go location and explicitly names the
Omni SDK as the non-TypeScript backbone.
docs(get-started/sdks): fill omni SDK pages + replace legacy Go page
@derekchiang derekchiang merged commit 10ee936 into main May 12, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants