Skip to content

Update EW introduction content#2790

Open
bgravenorst wants to merge 6 commits intomainfrom
DOC-2782
Open

Update EW introduction content#2790
bgravenorst wants to merge 6 commits intomainfrom
DOC-2782

Conversation

@bgravenorst
Copy link
Copy Markdown
Contributor

@bgravenorst bgravenorst commented Mar 25, 2026

Description

  • Add a graphic that helps users quickly understand how embedded wallets differ from traditional wallets
  • Updates to remove marketing tone, tighten language, and improve clarity.
  • Move conceptual architecture information into a dedicated topic.
  • Ensured the architecture diagram is presented as a supporting visual, not the primary source of
    information (accessibility issue).
  • Added content to improve description of the architecture content.

Issue(s) fixed

Fixes #2782

Preview

https://metamask-docs-git-doc-2782-consensys-ddffed67.vercel.app/embedded-wallets/

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.

Note

Low Risk
Documentation-only changes plus a new static SVG asset and sidebar entry; no runtime product logic changes, with minimal risk limited to broken links/assets or rendering issues.

Overview
Updates the Embedded Wallets landing page (embedded-wallets/README.mdx) to be more concise/less marketing-focused, adds an onboarding comparison graphic, and removes the client-only modal/inline architecture content in favor of a single link.

Introduces a new dedicated embedded-wallets/architecture.mdx doc that explains the high-level login/key-share flow and hosts the existing architecture diagram and wallet infrastructure overview, and adds it to the docs sidebar (ew-sidebar.js).

Reviewed by Cursor Bugbot for commit 299db2f. Bugbot is set up for automated code reviews on this repo. Configure here.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
@bgravenorst bgravenorst requested review from a team as code owners March 25, 2026 03:57
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 25, 2026

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

Project Deployment Actions Updated (UTC)
metamask-docs Ready Ready Preview, Comment Apr 8, 2026 9:13am

Request Review

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Copy link
Copy Markdown

@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 1 potential issue.

Fix All in Cursor

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Signed-off-by: bgravenorst <byron.gravenorst@consensys.net>
Copy link
Copy Markdown
Member

@yashovardhan yashovardhan left a comment

Choose a reason for hiding this comment

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

LGTM

### Authentication

Get your users started in seconds with familiar login methods they already use:
Help users get started quickly with login methods they already use:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
Help users get started quickly with login methods they already use:
Help users get started quickly with sign-in methods they already use:

- Distributed architecture prevents single points of failure
- Multiple backup options for worry-free recovery
- Users maintain 100% control of their non-custodial wallets.
- A distributed architecture prevents single points of failure
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
- A distributed architecture prevents single points of failure
- A distributed architecture prevents single points of failure.

Comment on lines +35 to +36
<source srcset={PnPCoreKitFlowLight} media="(prefers-color-scheme: light)" />
<source srcset={PnPCoreKitFlowDark} media="(prefers-color-scheme: dark)" />
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The light image appears on both light and dark mode for me (however, this is not a regression as the current site has the same behavior).

</BrowserOnly>
Users get a smoother onboarding experience while retaining control of non-custodial wallets.

## Key features
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The items in these lists are not fully consistent in sentence structure. We should call this out in the cursor rules.

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.

[Docs] Embedded Wallets: clarify traditional vs embedded wallet in intro

3 participants