[docs-infra] Deploy Docs to Netlify #1019

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

dav-is merged 16 commits into master from docs-infra/deploy-to-netlify

Jan 9, 2026

docs/README.md

-Original file line number
+Diff line change
@@ Expand Up / @@ -3,7 +3,8 @@ @@
     This package contains the documentation for the MUI Infra project, which is responsible for the infrastructure and tooling used in the various MUI documentation sites and libraries.
     [Read in Markdown](<./app/(shared)/page.mdx>)
-    [Read in Browser](https://infra.mui.com)
+    [Read in Browser](https://mui-internal.netlify.app/)
     For the most immersive experience, we recommend opening this documentation in VSCode, starting with this README and working deeper into the documentation by navigating through the links provided (ctrl + click). You should have [the MDX extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) installed to view the documentation properly.
@@ Expand Down @@

...s-infra/components/code-controller-context/demos/code-editor/CodeEditorContent.module.css

-Original file line number
+Diff line change
@@ Expand Up / @@ -35,3 +35,7 @@ @@
       padding: 6px;
       overflow-x: auto;
     }
+    .codeBlock:focus-visible {
+      outline: none;
+    }

.../docs-infra/components/code-controller-context/demos/demo-live/DemoLiveContent.module.css

-Original file line number
+Diff line change
@@ Expand Up / @@ -70,3 +70,7 @@ @@
       padding: 6px;
       overflow-x: auto;
     }
+    .codeBlock:focus-visible {
+      outline: none;
+    }

docs/app/docs-infra/components/code-controller-context/demos/multi-file/MultiFileEditor.tsx

            
                      Original file line number
                      Diff line number
                      Diff line change
                  
    @@ -23,17 +23,17 @@ export default function App() {
  
          'styles.css': {

            source: `.container {

      padding: 20px;

      background: #f5f5f5;

      background: #f2eff3;

      border-radius: 8px;

    }

    h1 {

      color: #333;

      color: #84828e;

      margin-bottom: 10px;

    }

    p {

      color: #666;

      color: #65636d;

      font-size: 14px;

    }`,

          },

0 ...ions/abstract-create-demo-client/page.mdx → ...ries/abstract-create-demo-client/page.mdx

File renamed without changes.

0 ...a/functions/abstract-create-demo/page.mdx → ...a/factories/abstract-create-demo/page.mdx

File renamed without changes.

0 ...infra/functions/create-demo-data/page.mdx → ...infra/factories/create-demo-data/page.mdx

File renamed without changes.

0 ...s-infra/functions/create-sitemap/page.mdx → ...s-infra/factories/create-sitemap/page.mdx

File renamed without changes.

docs/app/docs-infra/factories/page.mdx

-Original file line number
+Diff line change
@@ -0,0 +1,121 @@
+    # Factories
+    [//]: # 'This file is autogenerated, but the following list can be modified.'
+    <PagesIndex>
+    - [Abstract Create Demo](#abstract-create-demo) - [Full Docs](./abstract-create-demo/page.mdx)
+    - [Create Sitemap](#create-sitemap) [New] - [Full Docs](./create-sitemap/page.mdx)
+    - [Abstract Create Demo Client](#abstract-create-demo-client) - [Full Docs](./abstract-create-demo-client/page.mdx)
+    - [Create Demo Data](#create-demo-data) - [Full Docs](./create-demo-data/page.mdx)
+    [//]: # 'This file is autogenerated, DO NOT EDIT AFTER THIS LINE, run: pnpm docs:validate docs-infra/factories'
+    ## Abstract Create Demo
+    The `abstractCreateDemo` function helps you create structured demo factories that work seamlessly with the [`CodeHighlighter`](../../components/code-highlighter/page.mdx) component ecosystem. It provides a standardized way to create demos that combine component previews with code display, making it easier to build consistent documentation interfaces.
+    <details>
+    <summary>Outline</summary>
+    - Sections:
+      - Overview
+      - Factory Function Requirements
+      - Implementation
+      - Global Dependencies
+        - Loader Configuration
+      - Related
+    </details>
+    [Read more](./abstract-create-demo/page.mdx)
+    ## Create Sitemap
+    The `createSitemap` factory function defines sitemap data for documentation sites. It works with the webpack loader for build-time precomputation in Next.js builds.
+    <details>
+    <summary>Outline</summary>
+    - Sections:
+      - Overview
+      - API Reference
+        - Parameters
+        - Returns
+        - Behavior
+      - Runtime Loading
+      - File Structure
+      - Type Definitions
+        - CreateSitemapMeta
+        - Sitemap
+        - SitemapSectionData
+        - SitemapPage
+      - Configuration
+        - Skip Precomputation
+        - Webpack Loader Setup
+      - Integration with Search
+      - Populating the Sitemap
+      - Related
+    </details>
+    [Read more](./create-sitemap/page.mdx)
+    ## Abstract Create Demo Client
+    The `abstractCreateDemoClient` function helps you create client-side demo providers that manage external dependencies for live component demos. It creates provider components that supply externals context to child components, enabling dynamic code execution in the browser.
+    <details>
+    <summary>Outline</summary>
+    - Sections:
+      - Overview
+      - When to Use Demo Clients
+      - Factory Function Requirements
+      - Implementation
+      - Usage Pattern
+      - Client Provider Features
+      - Configuration Options
+        - AbstractCreateDemoClientOptions
+        - CreateDemoClientMeta
+      - Externals Context
+      - Best Practices
+      - Example: Complete Live Demo Setup
+      - Related
+    </details>
+    [Read more](./abstract-create-demo-client/page.mdx)
+    ## Create Demo Data
+    The `createDemoData` utility creates structured demo metadata and component data for use with the [`CodeHighlighter`](../components/code-highlighter/page.mdx) system. It processes demo URLs, components, and metadata to create data objects that can be consumed by demo factories and code highlighting systems.
+    <details>
+    <summary>Outline</summary>
+    - Sections:
+      - Features
+      - Usage
+        - Global Demo Data Structure
+          - Global Variant Matching
+      - When to Use
+      - Related
+    </details>
+    [Read more](./create-demo-data/page.mdx)
+    </PagesIndex>
+    [//]: # 'This file is autogenerated, but the following metadata can be modified.'
+    export const metadata = {
+      robots: {
+        index: false,
+      },
+    };

docs/app/docs-infra/hooks/use-url-hash-state/demos/tab-navigation/TabNavigation.module.css

-Original file line number
+Diff line change
@@ Expand Up / @@ -11,7 +11,7 @@ @@
       display: flex;
       gap: 0;
       border-bottom: 1px solid #d0cdd7;
-      background-color: #f5f5f5;
+      background-color: #f2eff3;
     }
     .tab,
@@ Expand Down @@

docs/app/docs-infra/layout.tsx

-Original file line number
+Diff line change
@@ Expand Up / @@ -5,6 +5,7 @@ import { Navigation } from '@/components/Navigation'; @@
     import styles from '../layout.module.css';
     import { sitemap } from '../sitemap';
     import { Search } from '../search';
+    import Notice from '../notice.mdx';
     export const metadata: Metadata = {
       title: 'MUI Docs Infra Documentation',
@@ Expand All / @@ -26,7 +27,12 @@ export default function RootLayout({ @@
           </div>
           <div className={styles.contentWrapper}>
             <Navigation sitemap={sitemap} />
-            <div className={styles.container}>{children}</div>
+            <div className={styles.container}>
+              <div className={styles.notice}>
+                <Notice />
+              </div>
+              <div className={styles.content}>{children}</div>
+            </div>
           </div>
         </div>
       );
@@ Expand Down @@

docs/app/docs-infra/page.mdx

Original file line number	Diff line number	Diff line change
Expand Up		@@ -69,4 +69,4 @@ If you want to contribute to the MUI Docs Infra project, please read the [Contri

		This project is licensed under the [MIT License](https://github.com/mui/mui-public/blob/master/LICENSE).

		This is an internal project, and is not intended for public use. No support or stability guarantees are provided. Use at your own risk.
		This is an internal project, and is not intended for public use. No support or stability guarantees are provided.

0 .../docs-infra/functions/hast-utils/page.mdx → ...p/docs-infra/pipeline/hast-utils/page.mdx

File renamed without changes.

0 ...nfra/functions/load-code-variant/page.mdx → ...infra/pipeline/load-code-variant/page.mdx

File renamed without changes.

0 ...computed-code-highlighter-client/page.mdx → ...computed-code-highlighter-client/page.mdx

File renamed without changes.

0 ...oad-precomputed-code-highlighter/page.mdx → ...oad-precomputed-code-highlighter/page.mdx

File renamed without changes.

0 ...nctions/load-precomputed-sitemap/page.mdx → ...ipeline/load-precomputed-sitemap/page.mdx

File renamed without changes.

0 .../functions/load-server-code-meta/page.mdx → ...a/pipeline/load-server-code-meta/page.mdx

File renamed without changes.

0 ...functions/load-server-page-index/page.mdx → .../pipeline/load-server-page-index/page.mdx

File renamed without changes.

0 ...ra/functions/load-server-sitemap/page.mdx → ...fra/pipeline/load-server-sitemap/page.mdx

File renamed without changes.

0 ...fra/functions/load-server-source/page.mdx → ...nfra/pipeline/load-server-source/page.mdx

File renamed without changes.

0 ...ocs-infra/functions/loader-utils/page.mdx → ...docs-infra/pipeline/loader-utils/page.mdx

File renamed without changes.

docs/app/docs-infra/functions/page.mdx → docs/app/docs-infra/pipeline/page.mdx

-Original file line number
+Diff line change
@@ -1,13 +1,9 @@
-    # Functions
+    # Pipeline
     [//]: # 'This file is autogenerated, but the following list can be modified. Automatically sorted alphabetically.'
     <PagesIndex>
-    - [Abstract Create Demo](#abstract-create-demo) - [Full Docs](./abstract-create-demo/page.mdx)
-    - [Abstract Create Demo Client](#abstract-create-demo-client) - [Full Docs](./abstract-create-demo-client/page.mdx)
-    - [Create Demo Data](#create-demo-data) - [Full Docs](./create-demo-data/page.mdx)
-    - [Create Sitemap](#create-sitemap) [New] - [Full Docs](./create-sitemap/page.mdx)
     - [HAST Utilities](#hast-utilities) - [Full Docs](./hast-utils/page.mdx)
     - [Load Code Variant](#load-code-variant) - [Full Docs](./load-code-variant/page.mdx)
     - [Load Precomputed Code Highlighter](#load-precomputed-code-highlighter) - [Full Docs](./load-precomputed-code-highlighter/page.mdx)
@@ Expand All / @@ -29,106 +25,7 @@ @@
     - [Transform Typescript To Javascript](#transform-typescript-to-javascript) - [Full Docs](./transform-typescript-to-javascript/page.mdx)
     - [With Docs Infra](#with-docs-infra) - [Full Docs](./with-docs-infra/page.mdx)
-    [//]: # 'This file is autogenerated, DO NOT EDIT AFTER THIS LINE, run: pnpm docs:validate docs-infra/functions'
-    ## Abstract Create Demo
-    The `abstractCreateDemo` function helps you create structured demo factories that work seamlessly with the [`CodeHighlighter`](../../components/code-highlighter/page.mdx) component ecosystem. It provides a standardized way to create demos that combine component previews with code display, making it easier to build consistent documentation interfaces.
-    <details>
-    <summary>Outline</summary>
-    - Sections:
-      - Overview
-      - Factory Function Requirements
-      - Implementation
-      - Global Dependencies
-        - Loader Configuration
-      - Related
-    </details>
-    [Read more](./abstract-create-demo/page.mdx)
-    ## Abstract Create Demo Client
-    The `abstractCreateDemoClient` function helps you create client-side demo providers that manage external dependencies for live component demos. It creates provider components that supply externals context to child components, enabling dynamic code execution in the browser.
-    <details>
-    <summary>Outline</summary>
-    - Sections:
-      - Overview
-      - When to Use Demo Clients
-      - Factory Function Requirements
-      - Implementation
-      - Usage Pattern
-      - Client Provider Features
-      - Configuration Options
-        - AbstractCreateDemoClientOptions
-        - CreateDemoClientMeta
-      - Externals Context
-      - Best Practices
-      - Example: Complete Live Demo Setup
-      - Related
-    </details>
-    [Read more](./abstract-create-demo-client/page.mdx)
-    ## Create Demo Data
-    The `createDemoData` utility creates structured demo metadata and component data for use with the [`CodeHighlighter`](../components/code-highlighter/page.mdx) system. It processes demo URLs, components, and metadata to create data objects that can be consumed by demo factories and code highlighting systems.
-    <details>
-    <summary>Outline</summary>
-    - Sections:
-      - Features
-      - Usage
-        - Global Demo Data Structure
-          - Global Variant Matching
-      - When to Use
-      - Related
-    </details>
-    [Read more](./create-demo-data/page.mdx)
-    ## Create Sitemap
-    The `createSitemap` factory function defines sitemap data for documentation sites. It works with the webpack loader for build-time precomputation in Next.js builds.
-    <details>
-    <summary>Outline</summary>
-    - Sections:
-      - Overview
-      - API Reference
-        - Parameters
-        - Returns
-        - Behavior
-      - Runtime Loading
-      - File Structure
-      - Type Definitions
-        - CreateSitemapMeta
-        - Sitemap
-        - SitemapSectionData
-        - SitemapPage
-      - Configuration
-        - Skip Precomputation
-        - Webpack Loader Setup
-      - Integration with Search
-      - Populating the Sitemap
-      - Related
-    </details>
-    [Read more](./create-sitemap/page.mdx)
+    [//]: # 'This file is autogenerated, DO NOT EDIT AFTER THIS LINE, run: pnpm docs:validate docs-infra/pipeline'
     ## HAST Utilities
@@ Expand Down @@

0 ...ocs-infra/functions/parse-source/page.mdx → ...docs-infra/pipeline/parse-source/page.mdx

File renamed without changes.

0 ...-infra/functions/sync-page-index/page.mdx → ...s-infra/pipeline/sync-page-index/page.mdx

File renamed without changes.

0 ...ra/functions/transform-html-code/page.mdx → ...fra/pipeline/transform-html-code/page.mdx

File renamed without changes.

0 ...orm-markdown-blockquote-callouts/page.mdx → ...orm-markdown-blockquote-callouts/page.mdx

File renamed without changes.

0 ...unctions/transform-markdown-code/page.mdx → ...pipeline/transform-markdown-code/page.mdx

File renamed without changes.

0 ...ns/transform-markdown-demo-links/page.mdx → ...ne/transform-markdown-demo-links/page.mdx

File renamed without changes.

0 ...ions/transform-markdown-metadata/page.mdx → ...line/transform-markdown-metadata/page.mdx

File renamed without changes.

0 ...ransform-markdown-relative-paths/page.mdx → ...ransform-markdown-relative-paths/page.mdx

File renamed without changes.

0 ...ansform-typescript-to-javascript/page.mdx → ...ansform-typescript-to-javascript/page.mdx

File renamed without changes.

0 ...-infra/functions/with-docs-infra/page.mdx → ...s-infra/pipeline/with-docs-infra/page.mdx

File renamed without changes.

docs/app/global.css

-Original file line number
+Diff line change
@@ -1,3 +1,21 @@
+    html {
+      /* Stable scrollbar */
+      overflow-y: scroll;
+      word-break: break-word;
+    }
+    body {
+      font-synthesis: none;
+      -webkit-font-smoothing: antialiased;
+      -moz-osx-font-smoothing: grayscale;
+    }
+    *,
+    ::before,
+    ::after {
+      box-sizing: border-box;
+    }
     @supports (view-transition-name: none) {
       ::view-transition-old(main-content) {
         animation-duration: 200ms;
@@ Expand Down @@

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[docs-infra] Deploy Docs to Netlify #1019

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!