Release tracking

[primer]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@primer/brand-mcp@0.70.0

Minor Changes

• #1384 d117f36 Thanks @rezrah! - Added @primer/brand-mcp, a Model Context Protocol (MCP) server that helps AI agents use Primer Brand correctly when building GitHub marketing and landing pages.

  It exposes version-aware tools like:

  • primer_brand_setup
  • primer_brand_page_design
  • primer_brand_component
  • primer_brand_examples
  • primer_brand_tokens
  • primer_brand_asset
  • primer_brand_docs
  • primer_brand_review

  These tools read the @primer/react-brand package that you already have installed and validates JSX and CSS against Primer design system conventions during agentic development.

  Add it to your MCP client using npx @primer/brand-mcp.

  For Copilot CLI, add the following to your ~/.copilot/mcp-config.json:

  {
    "mcpServers": {
      "primer-brand": {
        "type": "local",
        "command": "npx",
        "args": ["@primer/brand-mcp@latest"],
        "tools": ["*"]
      }
    }
  }

@primer/react-brand@0.70.0

Minor Changes

• #1382 04e5a9d Thanks @rezrah! - ⚠️ Changes to the files listed in the package: lib/ (UMD) and esm/ (ESM) bundles now ship a clean, filtered list of React modules and type declarations (everything exported from index.ts). Internal-only modules that were never intended for the package like recipes/ and Storybook test fixtures/ — are no longer included:

  - @primer/react-brand/esm/recipes/**
  - @primer/react-brand/{lib,esm}/**/fixtures/**
  - @primer/react-brand/{lib,esm}/**/*.fixtures.d.ts

• #1378 c51633e Thanks @danielguillan! - Adds the NavList component for vertical navigation with groups, nested expandable links, current item states, and custom link support.

  See docs for usage examples

Patch Changes

• #1382 04e5a9d Thanks @rezrah! - Version-pinned documentation is now bundled in @primer/react-brand. Each release now ships Markdown documentation at parity with primer.style/brand under docs/, plus an llms.txt index. This is to help agents reference documentation that matches their installed version instead relying on the latest version of documentation published to primer.style/brand, which may be ahead of what's locally installed.

• #1379 7497dc7 Thanks @danielguillan! - Update Token text styles to use sans-serif and remove the uppercase transform.

• #1385 7d7800f Thanks @rezrah! - Reduced the gap between Footnotes items from 24px to 12px

• #1384 d117f36 Thanks @rezrah! - Added inert JSDoc annotations to the Heading component's as and size props clarifying that as sets only the semantic heading level while size controls the visual size.

• #1384 d117f36 Thanks @rezrah! - Adds a dev-only warning to prevent center aligned Hero content when variant="gridline-expressive". This should always remain start aligned. We not silently prevent this from happening in the Hero component.

  The primer_brand_review MCP tool also gains an extendable invalid-prop-combination rule that flags unsupported pairings like this.

• #1385 7d7800f Thanks @rezrah! - Adjusted the padding in the gridline-expressive variant of Hero on narrow viewports

• #1211 06c14a2 Thanks @rezrah! - Added descriptive labels to Footnote return links for an improved screen-reader experience. Return links will now be read aloud as "Back to content {Link label}"

• #1387 af3ac05 Thanks @danielguillan! - Adjusted the spacing in the MediaPlaylist component on narrow viewports

• #1387 af3ac05 Thanks @danielguillan! - Increased the border-radius of icons in the Pillar component to 12px

• #1385 7d7800f Thanks @rezrah! - Increased the border-radius of icons in the SectionIntroStacked component from 8px to 12px

• #1387 af3ac05 Thanks @danielguillan! - Updated the Statistic social proof example to use consistent text colors

• #1387 af3ac05 Thanks @danielguillan! - Adjusted the Tiles grid to use three columns on tablet viewports

@primer/brand-css@0.70.0

@primer/brand-primitives@0.70.0

@primer/brand-docs@0.70.0

@primer/brand-storybook@0.70.0

@primer/brand-e2e@0.70.0

@primer/brand-fonts@0.70.0

@primer/brand-config@0.70.0

[github-actions]

❗ Pre-merge checklist

Please ensure these items are checked before merging.

✅ Preliminary checks

• All CI checks pass on this pull request
• Docs and Storybook previews open in a browser

🔌 Integration smoke tests

Dotcom

• Performed successful integration test with github/github-ui, as a primary consumer of Primer Brand
  • Install RC: npm install @primer/react-brand@{RC_VERSION} -w @github-ui/swp-core
  • Run development server
  • Manually verify release-specific bugfixes and/or features on the following pages:
    • /home
    • /features/copilot
    • /features/copilot/plans
    • /features/copilot/tutorials
    • /features/preview
    • /enterprise
    • /enterprise/contact
    • /security/advanced-security
    • /education
    • /mobile
    • /about/diversity
    • /newsroom
    • /resources/articles
    • /resources/articles/software-development
    • /resources/articles/software-development/what-is-cloud-native
    • /resources/whitepapers
    • /resources/whitepapers/how-the-c-suite-can-lead-ai-innovation
    • /solutions
    • /solutions/use-case/
    • /solutions/use-case/devops
    • /contentful-lp-tests/flex-example-dark (requires a flag)
    • /contentful-lp-tests/flex-example-light (requires a flag)
  • Manually compare production site to local instance for any non-release specific regressions

Subdomain sites

• Performed successful integration test with githubuniverse.com, as a Tier 1 consumer of Primer Brand outside of the monolith.

  • Run development server and verify no new console warnings or regressions are found
  • Run local build to verify the release compiles correctly
  • Manually performed side-by-side comparison with production

• Performed successful integration test with https://resources.github.com/, as a Tier 1 consumer of Primer Brand outside of the monolith.

  • Run development server and verify no new console warnings or regressions are found
  • Run local build to verify the release compiles correctly
  • Manually performed side-by-side comparison with production

Sandboxes

• Works in CodeSandbox or StackBlitz
  • New components render successfully
  • (optional) Tested in both SPA and SSR apps if release contains build changes

🤔 Cross-check (aka sanity test)

• Release notes accurately describe the changes made
• All bugfixes in this release have resolved their corresponding issues
• The issues for reverted PRs have been re-opened and commented on with a link to the reverted PR
• No noticeable regressions or side-effects have not been introduced as a result of changes in this release.
  • If they have, determine severity of the issue and consider hotfixing

After tests

• Add report summary of your findings, including any images. Use following template as a guide:

  #### Smoke test results
  
  - Feature 1 🟢 🟡 🔴 (choose one, depending on success levels)
  
    {insert screenshot}
  
  Release testing status: Ready to release 🟢 | Paused 🟡 🔴 (choose one and provide reason)

🚢 After merge

• Issue release comms in primer brand Slack channel
• Add the preview deployment's link to releases as a way of permalinking to old version's docs. Example

[github-actions]

🟢 No design token changes found

[github-actions]

🟢 Bundle size report

Check	Main	Branch	Change
UMD — full bundle (JS)	101.33 kB	101.33 kB	🟢 No change
UMD — full bundle (CSS)	66.82 kB	66.82 kB	🟢 No change
ESM — full bundle (JS + CSS)	1.51 MB	1.51 MB	🟢 No change
ESM — tree-shaken simple (Button)	69.70 kB	69.70 kB	🟢 No change
ESM — tree-shaken complex (ActionMenu)	78.48 kB	78.48 kB	🟢 No change

[github-actions]

🟢 No unit test coverage changes found

All components and hooks with tests maintain the same coverage as the main branch.

[github-actions]

🟢 No visual differences found

Our visual comparison tests did not find any differences in the UI.

[rezrah]

Smoke test results

• NavList 🟢

  Looking great in Storybook on Dotcom. Net-new component so verified in Storybook only.

  

• Token styles 🟢

  Test in storybook. Confirmed sans-serif (Mona Sans) + lowercase. No regressions observed.

  

• Footnotes gap 🟢

  Footnotes now have reduced spacing. Confirmed and works as expected.

• Footnote return links 🟢

  Confirmed and works as expected.

• Pillar radius 🟢

  Verified now using 12px on CLI page

• Statistic colors 🟢

  No regressions observed.

• MediaPlaylist spacing 🟢

  Tested in storybook (Flex Suite Details). Renders correctly. No regressions observed.

• SectionIntroStacked radius 🟢

  Shared icon-background corner radius confirmed at 12px via Pillar. No regressions observed.

• Tiles tablet 🟢

  Works as expected

• Hero gridline-expressive 🟢

  Not used anywhere in prod, but storybook confirms it works as expected.

• Package file filtering (recipes/fixtures) 🟢

  Recipes no longer appear in node_modules

Release testing status: Ready to release 🟢