This repository contains the source for docs.metamask.io, the MetaMask developer documentation site. It is built with Docusaurus and covers multiple products aimed at dapp developers and wallet extension builders.
| Product | Path | Sidebar file | Description |
|---|---|---|---|
| MetaMask Connect | metamask-connect/ |
mm-connect-sidebar.js |
Connect dapps to MetaMask extension and mobile, across EVM, Solana, and multichain. |
| Embedded Wallets | embedded-wallets/ |
ew-sidebar.js |
Embed wallet functionality directly into applications. |
| Smart Accounts Kit | smart-accounts-kit/ |
gator-sidebar.js |
Create smart accounts with delegated permissions, and request advanced permissions. |
| Agent Wallet | agent-wallet/ |
agent-wallet-sidebar.js |
Give AI agents programmatic wallet access via the mm CLI with mandatory security. |
| Agent Wallet | agent-wallet/ |
agent-wallet-sidebar.js |
Give AI agents programmatic wallet access via the mm CLI with mandatory security. |
| Snaps | snaps/ |
snaps-sidebar.js |
Extend MetaMask by creating custom mini-apps. |
Infura API and dashboard documentation lives at Infura documentation in the Infura docs repository.
Follow these guides when writing or editing documentation:
- Consensys documentation style guide
- Consensys Markdown formatting guide
- Microsoft Writing Style Guide
- Diataxis framework for content structure
The rules under .cursor/rules/ cover the most actionable parts of these references.
See CONTRIBUTING.md for the full contribution workflow.
- Do not invent API behavior. Never state as fact any API parameter, return value, or behavior that you have not verified against the codebase or published reference. If you are uncertain, flag it for review.
- Respect product boundaries. Each product has its own documentation tree and sidebar. Do not move content across product boundaries without explicit approval from the documentation team.
- Use the canonical terminology. See
.cursor/rules/terminology.mdcfor the required spelling and casing of product and industry terms. - Verify before publishing. Preview changes locally with
npm startbefore requesting review. - Pass the CI linter. PRs are checked by a Vale-based linter that enforces Microsoft style and Consensys terminology. Fix warnings before requesting review.
Detailed editorial, formatting, and product-specific rules are in .cursor/rules/. These rules
apply automatically when you edit files matching their glob patterns.
Agent skills live under .cursor/skills/<skill-name>/SKILL.md. This repo includes author-page
(scaffold and draft new pages) and style-review (editorial compliance before PR). Cursor loads
these when the task matches each skill's description.