[docs-infra] Update Index to Filter Private Entries by dav-is · Pull Request #4239 · mui/base-ui

dav-is · 2026-03-02T20:36:25Z

Update pages index to use new format from mui/mui-public#1109 released in 0.5.1-canary.0

Adds private Calendar page: https://deploy-preview-4239--base-ui.netlify.app/react/components/calendar (this page will not appear at https://master--base-ui.netlify.app/). Based on this ENV variable: https://github.com/mui/mui-public/blob/df142b55588e09b911db8be848c133b0ebad1cc0/packages/docs-infra/src/withDocsInfra/withDeploymentConfig.ts#L8-L46

Also adds filtering from navigation and search when pages are marked with audience: private:

export const metadata =
  /** @type {import('@mui/internal-docs-infra/createSitemap/types').NextMetadata} */ ({
    robots: {
      index: false,
    },
    other: {
      audience: 'private',
    },
  });

metadata.robots.index: false is how Next.js adds the no-index meta: https://nextjs.org/docs/app/api-reference/functions/generate-metadata#robots

pkg-pr-new · 2026-03-02T20:38:16Z

base-ui-tanstack-start

vite-css-base-ui-example

pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/react@4239

pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/utils@4239

commit: 811750b

mui-bot · 2026-03-02T20:38:20Z

Bundle size report

Bundle	Parsed size	Gzip size
@base-ui/react	0B^(0.00%)	0B^(0.00%)

Details of bundle changes

Check out the code infra dashboard for more information about this PR.

netlify · 2026-03-02T20:45:11Z

✅ Deploy Preview for base-ui ready!

Name	Link
🔨 Latest commit	`0f21dc1`
🔍 Latest deploy log	https://app.netlify.com/projects/base-ui/deploys/69b018019fa6890008857fb5
😎 Deploy Preview	https://deploy-preview-4239--base-ui.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

…ntries

mnajdova

Let's revert the unnecessary changes to the mdx files, only keep the relevant changes and change one mdx to private just so we can test things out.

mnajdova · 2026-03-04T15:35:00Z

docs/src/app/(docs)/react/components/accordion/page.mdx

-  ],
-};
+export const metadata =
+  /** @type {import('@mui/internal-docs-infra/pipeline/transformMarkdownMetadata/types').Metadata} */ ({


Can we add the typeonly on pages that actually use params not defined in the next.js type?

Right now the metadata doesn't have any JSDocs so even the Next.js types aren't shown when hovering or autocomplete. If we have the type here, then our added metadata options are discoverable. This type extends Next.js' types too.

If we don't put our metadata type here, I think we should at least put the @type for Next.js metadata.

Edit: I reverted this for now

We can do it in a follow-up, just so we don't clatter this PR.

docs/src/app/(docs)/react/handbook/page.mdx

docs/src/components/Header.tsx

dav-is · 2026-03-04T16:23:10Z

I'll separate out the unrelated changes into another PR to keep this one minimal

…ntries

dav-is · 2026-03-04T20:12:56Z

@mnajdova Ok, the unrelated changes are reverted, I renamed to isPrivate, and I added an empty calendar page to test: https://deploy-preview-4239--base-ui.netlify.app/react/components/calendar

mnajdova

Thanks for isolating some changes, can you answer few last questions?

docs/src/app/(docs)/react/overview/page.mdx

docs/src/components/Search/Search.tsx

docs/src/app/(docs)/layout.tsx

…ntries

…thub.com:dav-is/base-ui into docs-infra/update-index-to-allow-private-entries

docs/src/app/(docs)/react/components/page.mdx

docs/src/app/(docs)/layout.tsx

mnajdova · 2026-03-05T16:31:48Z

It looks good to me 👌 Do you plan to add more things in this PR? I am asking because it's still in draft

dav-is · 2026-03-05T16:33:08Z

Do you plan to add more things in this PR?

No, I can do it in a followup PR. It's a draft because we need to merge mui/mui-public#1109 before this PR can be merged. That PR should be ready to go whenever it is approved

brijeshb42 · 2026-03-06T14:09:01Z

docs/src/app/(docs)/react/components/calendar/page.mdx

+  /** @type {import('@mui/internal-docs-infra/createSitemap/types').NextMetadata} */ ({
+    keywords: [],
+    robots: {
+      index: false,


Will this work for the generateMetadata function ?

generateMetadata is not supported by page indexes today because it requires running the build and rendering the page. When we use export const metadata, we can statically analyze by parsing the file. I want to support it eventually, but we need to further optimize Base UI's build pipeline so that a cached build takes less than 5 seconds (my target).

…te-entries

mnajdova

I left two more comments, I don't see anything blocking. Let's update the infra package and merge this one 👌

mnajdova · 2026-03-10T08:18:56Z

docs/src/app/(docs)/react/components/calendar/page.mdx

@@ -0,0 +1,18 @@
+# Calendar


We can drop this page as there are other pages where we can test the private flag.

mnajdova · 2026-03-10T08:20:03Z

docs/src/app/(docs)/layout.tsx

 import 'docs/src/css/index.css';
 import './layout.css';

+const showPrivatePages = process.env.SHOW_PRIVATE_PAGES === 'true';


We should make sure we don't forget to set this flag before the next deployment.

This is set within docs-infra code withDeploymentConfig

…ntries

dav-is added 2 commits March 2, 2026 14:56

Update index format

10b220a

Add filtering based on audience

2cfbb54

dav-is added type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature. scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305). labels Mar 2, 2026

dav-is mentioned this pull request Mar 2, 2026

[docs-infra] Add audience and index fields to page index metadata mui/mui-public#1109

Merged

Fix remaining pages metadata

5b6a69e

dav-is added 7 commits March 2, 2026 16:10

bump docs-infra

c852df4

Fix title display

673b97c

Add Private indicator

6fc4222

Bump docs-infra

1b2de0b

bump docs-infra

f4d0ee8

Merge branch 'master' into docs-infra/update-index-to-allow-private-e…

86a339e

…ntries

Merge branch 'master' into docs-infra/update-index-to-allow-private-e…

1017416

…ntries

mnajdova reviewed Mar 4, 2026

View reviewed changes

dav-is added 7 commits March 4, 2026 14:26

Revert metadata export @type

0476496

Bump docs-infra

aadb762

Add private calendar page

d3c5de6

Merge branch 'master' into docs-infra/update-index-to-allow-private-e…

cc47c77

…ntries

Shorten @type import

ffac9fa

Bump docs-infra

cbcf9ce

Update index

26dffd3

dav-is requested a review from mnajdova March 4, 2026 20:12

Only show private pages in PR preview deploys

76fa077

mnajdova reviewed Mar 5, 2026

View reviewed changes

docs/src/app/(docs)/react/overview/page.mdx Outdated Show resolved Hide resolved

docs/src/components/Search/Search.tsx Outdated Show resolved Hide resolved

mnajdova reviewed Mar 5, 2026

View reviewed changes

docs/src/app/(docs)/layout.tsx Outdated Show resolved Hide resolved

dav-is added 3 commits March 5, 2026 11:15

Merge branch 'master' into docs-infra/update-index-to-allow-private-e…

edd484f

…ntries

Code review

0737023

Merge branch 'docs-infra/update-index-to-allow-private-entries' of gi…

083ddee

…thub.com:dav-is/base-ui into docs-infra/update-index-to-allow-private-entries

mnajdova reviewed Mar 5, 2026

View reviewed changes

docs/src/app/(docs)/react/components/page.mdx Show resolved Hide resolved

mnajdova reviewed Mar 5, 2026

View reviewed changes

docs/src/app/(docs)/layout.tsx Show resolved Hide resolved

brijeshb42 reviewed Mar 6, 2026

View reviewed changes

dav-is added 2 commits March 9, 2026 11:21

bump docs-infra

298c263

Merge branch 'mui:master' into docs-infra/update-index-to-allow-priva…

00b3cbf

…te-entries

dav-is marked this pull request as ready for review March 9, 2026 16:18

dav-is requested review from atomiks, colmtuite and michaldudak as code owners March 9, 2026 16:18

This was referenced Mar 9, 2026

Bump MUI infra packages #4291

Merged

[temporal] New Calendar component #1973

Open

mnajdova approved these changes Mar 10, 2026

View reviewed changes

Merge branch 'master' into docs-infra/update-index-to-allow-private-e…

0f21dc1

…ntries

dav-is merged commit 50b1996 into mui:master Mar 10, 2026
22 checks passed

dav-is deleted the docs-infra/update-index-to-allow-private-entries branch March 10, 2026 13:43

Uh oh!

Conversation

dav-is commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mui-bot commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle size report

Uh oh!

netlify bot commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for base-ui ready!

Uh oh!

mnajdova left a comment

Choose a reason for hiding this comment

Uh oh!

mnajdova Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

dav-is Mar 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mnajdova Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

dav-is commented Mar 4, 2026

Uh oh!

dav-is commented Mar 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mnajdova left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mnajdova commented Mar 5, 2026

Uh oh!

dav-is commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

brijeshb42 Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

dav-is Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mnajdova left a comment

Choose a reason for hiding this comment

Uh oh!

mnajdova Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

mnajdova Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

dav-is Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dav-is commented Mar 2, 2026 •

edited

Loading

pkg-pr-new bot commented Mar 2, 2026 •

edited

Loading

mui-bot commented Mar 2, 2026 •

edited

Loading

netlify bot commented Mar 2, 2026 •

edited

Loading

dav-is Mar 4, 2026 •

edited

Loading

dav-is commented Mar 4, 2026 •

edited

Loading

mnajdova left a comment •

edited

Loading

dav-is commented Mar 5, 2026 •

edited

Loading

dav-is Mar 6, 2026 •

edited

Loading