Skip to content

2717 simplify ux#2718

Open
m4sterbunny wants to merge 12 commits intomainfrom
2717-simplify-ux
Open

2717 simplify ux#2718
m4sterbunny wants to merge 12 commits intomainfrom
2717-simplify-ux

Conversation

@m4sterbunny
Copy link
Contributor

@m4sterbunny m4sterbunny commented Feb 18, 2026

Description

Proposes simpler user journey (landing on a 3 step get started)

  1. Simplifies lhs nav of overview:
  • collapses "Choose your platform" which is a redundancy feature if user doesnt use the get started: could go entirely

Rather than have the redundancy, there could be a page per platform offering links out to 1. Quickstart 2. Get started (for those frameworks/platforms that have both)

  • The how it works and previous intro text are all in the About (with no file rename to prevent need for redirect)
  • Features: not yet sure about repeating the features across sdks -- per suggestion
  1. Moves dashboard from Overview's LHS nav to dedicated nav (replacing previous external link)

Issue(s) fixed

Fixes #2717

Preview

Checklist

  • If this PR updates or adds documentation content that changes or adds technical meaning, it has received an approval from an engineer or DevRel from the relevant team.
  • If this PR updates or adds documentation content, it has received an approval from a technical writer.

External contributor checklist

  • I've read the contribution guidelines.
  • I've created a new issue (or assigned myself to an existing issue) describing what this PR addresses.

Note

Medium Risk
Medium risk because it changes doc IA/sidebars and introduces redirects, which can break deep links or navigation if any IDs/paths are misconfigured; no runtime or security-sensitive code changes.

Overview
Refactors the Embedded Wallets docs landing experience: embedded-wallets/README.mdx is repositioned as About (SEO metadata updated) and now includes the previously separate “how it works” architecture/infrastructure overview content, while the old tile-based “Get started” section is moved out.

Adds a new embedded-wallets/get-started.mdx 3-step Get started page (account creation, platform selection tiles, app configuration) and updates internal references (for example features/mpc.mdx and infrastructure/README.mdx) to point to the new/merged overview location.

Restructures navigation: ew-sidebar.js now shows About and Get Started, collapses “Choose your platform”, and moves Dashboard docs into a dedicated dashboard sidebar section; the top subnav (SubNavBar/configs.ts) swaps the external dashboard link for an internal /embedded-wallets/dashboard/ entry. Adds a Vercel redirect from /embedded-wallets/how-it-works/ to /embedded-wallets/.

Written by Cursor Bugbot for commit 1445b74. This will update automatically on new commits. Configure here.

Signed-off-by: m4sterbunny <harrie.bickle-ext@consensys.net>
@m4sterbunny m4sterbunny requested review from a team as code owners February 18, 2026 14:20
@vercel
Copy link

vercel bot commented Feb 18, 2026

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

Project Deployment Actions Updated (UTC)
metamask-docs Ready Ready Preview, Comment Feb 27, 2026 8:35am

Request Review

@bgravenorst
Copy link
Contributor

The "Get started" appears to be the landing page when we select the product. Is this intentional?

@m4sterbunny
Copy link
Contributor Author

@bgravenorst yes deliberate-- was prioritizing shortest path so put user on the get started page
Didnt move About below Get started, wanted to discuss first

@bgravenorst
Copy link
Contributor

bgravenorst commented Feb 20, 2026

@bgravenorst yes deliberate-- was prioritizing shortest path so put user on the get started page Didnt move About below Get started, wanted to discuss first

It's inconsistent with the other products. And I think we should land on the intro topics. Perhaps a solution would be to have links to "About" and "Get started" on the landing page cards? (Something to consider in the future)

Screenshot 2026-02-20 at 2 54 42 pm

But anyone going Via the Products menu should go to the intro page.

### Step 1: Create a developer account

:::note
Sign up at the Embedded Wallets dashboard: [dashboard.web3auth.io](https://dashboard.web3auth.io/). The basic plan
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add the link on "Embedded Wallets dashboard"?

Copy link
Contributor Author

@m4sterbunny m4sterbunny Feb 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Yes, I like the card having the option to learn more or just get started.
  2. Putting the dashboard url into visibility was deliberate/for discussion: because there's still a disconnect between the new and old brands, I thought that may save us from yet another admonition stating that web3auth is still in the code/dash. I guess it jarred you?! It's the only instance, all others are links from "[Embedded Wallets dashboard]"

@m4sterbunny
Copy link
Contributor Author

Notice that the "Choose your platform" nav could be considered redundant if the Get Started is the primary path (and is search friendly). Either it can go, or rather than being an abstraction like so:
{
type: "category",
label: "Choose your platform",
...
items: [
{ type: "link", label: "React", href: "/embedded-wallets/sdk/react" },
{ type: "link", label: "Vue", href: "/embedded-wallets/sdk/vue" },
...

There could be pages offering the Get started and the Quickstart paths (for those that have quickstarts):

label path quickstart path
React /embedded-wallets/sdk/react src/pages/quickstart/builder/embedded-wallets/react
Vue /embedded-wallets/sdk/vue src/pages/quickstart/builder/embedded-wallets/vue
JavaScript /embedded-wallets/sdk/js
Node.js /embedded-wallets/sdk/node
Android /embedded-wallets/sdk/android src/pages/quickstart/builder/embedded-wallets/android
iOS /embedded-wallets/sdk/ios src/pages/quickstart/builder/embedded-wallets/ios
React Native /embedded-wallets/sdk/react-native src/pages/quickstart/builder/embedded-wallets/react_native
Flutter /embedded-wallets/sdk/flutter src/pages/quickstart/builder/embedded-wallets/flutter
Unity /embedded-wallets/sdk/unity
Unreal Engine /embedded-wallets/sdk/unreal

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 3 potential issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Embedded Wallets: simplify ux

3 participants