Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Add missing controller guidelines

Open Beginner friendly
#5,335 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
67/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
typescript
Domain
documentation

Research direction

Find the existing controller guidelines and package guidelines in the repository; the issue does not name their files. Read the surrounding guidance, then incorporate the listed controller state, test setup, messenger mocking, and package-version notes where appropriate. Done when the relevant guidelines cover these points without duplicating or contradicting existing guidance.

Written by the indexing model from the issue text.

Description

category-documentation github-migration-triaged team-wallet-framework wf-documentation

We have some missing controller guidelines:

  • State should be coherent at all times. If properties are intended to be used in conjunction with each other they should be consistent, and we should have runtime validation to ensure that this is always the case.
  • Use withController or setupController pattern to set up controllers in tests.
  • Don't mock the messenger in tests.

Although the following is a package guideline, we could consider repeating it in the controller guidelines because that is probably more likely the use case:

  • New controller packages should always start at 0.0.0 (otherwise they run the risk of being accidentally published).
Dominant language
TypeScript
Stars
413
Forks
308
Avg merge
1d 4h
Merged PRs (30d)
253

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MetaMask/core

All issues in MetaMask/core

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.