Skip to content

docs: HeaderBase migration (mobile)#1100

Merged
kirillzyusko merged 2 commits into
mainfrom
feat/header-base-migration
May 5, 2026
Merged

docs: HeaderBase migration (mobile)#1100
kirillzyusko merged 2 commits into
mainfrom
feat/header-base-migration

Conversation

@kirillzyusko

@kirillzyusko kirillzyusko commented Apr 21, 2026

Copy link
Copy Markdown
Collaborator

Description

Added migration docs for HeaderBase component (mobile).

Related issues

Fixes: https://consensyssoftware.atlassian.net/browse/DSYS-282

Manual testing steps

  1. Check MIGRATION.MD file;
  2. Check HeaderBase section;

Screenshots/Recordings

Before

N/A

After

image

Pre-merge author checklist

  • I've followed MetaMask Contributor Docs
  • I've completed the PR template to the best of my ability
  • I’ve included tests if applicable
  • I’ve documented my code using JSDoc format if applicable
  • I’ve applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Pre-merge reviewer checklist

  • I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
  • I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

Note

Low Risk
Low risk docs-only change; no runtime behavior or public API is modified in this PR.

Overview
Adds a new HeaderBase section to MIGRATION.md describing how to migrate from the mobile component-library to @metamask/design-system-react-native, including import changes, removal of HEADERBASE_TEST_ID/HEADERBASE_TITLE_TEST_ID in favor of explicit testID/titleTestID, and the fixed-height Display variant behavior.

Updates the HeaderBase component README to link to the new migration guide for downstream consumers.

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

@kirillzyusko kirillzyusko self-assigned this Apr 21, 2026
@kirillzyusko kirillzyusko added the documentation Improvements or additions to documentation label Apr 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@kirillzyusko kirillzyusko marked this pull request as ready for review April 22, 2026 10:08
@kirillzyusko kirillzyusko requested a review from a team as a code owner April 22, 2026 10:08

@georgewrmarshall georgewrmarshall left a comment

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.

Could we maybe make some improvements to this component based on this thread https://consensys.slack.com/archives/C02VD8QG0LT/p1776890507679999

@kirillzyusko

Copy link
Copy Markdown
Collaborator Author

@georgewrmarshall was it handled in #1103?

@georgewrmarshall

Copy link
Copy Markdown
Contributor

@georgewrmarshall was it handled in #1103?

Yes but it's a rough draft needs to be refined I'll work on it tomorrow. Apologies for the blocker.

@georgewrmarshall georgewrmarshall left a comment

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.

Approved for the current HeaderBase API on main.

One follow-up note: this migration guide is documenting the pre-refactor HeaderBase shape, so it will need to be revisited if/when #1103 lands first. That refactor removes HeaderBaseVariant/variant and replaces titleTestID with textProps, so this section should be refreshed to match the final API after the refactor settles.


The `HeaderBase` component is a flexible header with optional start/end accessories and a configurable title variant. Migration is nearly a drop-in swap — most consumers change the import, remove two constant imports, and switch any affected test IDs to explicit props.

#### Breaking Changes

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.

non-blocking: This looks correct for the current HeaderBase API on main, but #1103 is changing this contract pretty substantially by removing HeaderBaseVariant / variant and moving string-title passthrough onto textProps. If that refactor merges first, this migration section will need a follow-up refresh so the docs keep describing the final target API rather than the transitional one.

@kirillzyusko kirillzyusko enabled auto-merge (squash) May 5, 2026 21:09
@github-actions

github-actions Bot commented May 5, 2026

Copy link
Copy Markdown
Contributor

📖 Storybook Preview

@kirillzyusko kirillzyusko merged commit 1865b72 into main May 5, 2026
44 checks passed
@kirillzyusko kirillzyusko deleted the feat/header-base-migration branch May 5, 2026 21:12
@brianacnguyen brianacnguyen mentioned this pull request May 8, 2026
20 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants