From 627072b148385ac342b8f84151720e8f2940f578 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 12 Sep 2026 16:08:49 +0000 Subject: [PATCH 1/2] docs: sync skill with emoji icon support and MDX client-side evaluation --- agent-context/context/skills/mintlify/SKILL.md | 2 +- .../context/skills/mintlify/reference/components.md | 4 ++-- .../context/skills/mintlify/reference/configuration.md | 6 ++++-- 3 files changed, 7 insertions(+), 5 deletions(-) diff --git a/agent-context/context/skills/mintlify/SKILL.md b/agent-context/context/skills/mintlify/SKILL.md index 2b5b85d3b..275c06099 100644 --- a/agent-context/context/skills/mintlify/SKILL.md +++ b/agent-context/context/skills/mintlify/SKILL.md @@ -123,7 +123,7 @@ keywords: ["relevant", "search", "terms"] | `title` | string | Page title in navigation and browser tabs. Auto-generated from the path if omitted. | | `description` | string | Brief description for SEO. Displays under the title. | | `sidebarTitle` | string | Short title for sidebar navigation. | -| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a URL or file path. | +| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a single emoji, a URL, or a file path. | | `tag` | string | Label next to page title in sidebar (e.g., "NEW"). | | `hidden` | boolean | Remove from sidebar. Page still accessible by URL. | | `mode` | string | Page layout: `default`, `wide`, `custom`, `frame`, `center`. | diff --git a/agent-context/context/skills/mintlify/reference/components.md b/agent-context/context/skills/mintlify/reference/components.md index 738467a4b..4fb17dc24 100644 --- a/agent-context/context/skills/mintlify/reference/components.md +++ b/agent-context/context/skills/mintlify/reference/components.md @@ -323,10 +323,10 @@ Text with inline icon. ``` Props: -- `icon` (string, required): Icon name, URL, or file path. +- `icon` (string, required): Font Awesome, Lucide, or Tabler icon name, a single emoji, a URL, or a file path. - `iconType` (string): Font Awesome style. - `size` (number): Pixel size. -- `color` (string): Hex color. +- `color` (string): Hex color. Not applied to emoji icons. ## Tooltips diff --git a/agent-context/context/skills/mintlify/reference/configuration.md b/agent-context/context/skills/mintlify/reference/configuration.md index b8ccc7b80..342d52d1f 100644 --- a/agent-context/context/skills/mintlify/reference/configuration.md +++ b/agent-context/context/skills/mintlify/reference/configuration.md @@ -57,7 +57,7 @@ The SKILL.md file lists common frontmatter fields. Here is the complete set. All | `title` | string | Page title in navigation and browser tabs. Auto-generated from the path if omitted. | | `description` | string | Brief description for SEO. Displays under the title. | | `sidebarTitle` | string | Short title for sidebar navigation. | -| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a URL or file path. | +| `icon` | string | Lucide, Font Awesome, or Tabler icon name. Also accepts a single emoji, a URL, or a file path. | | `iconType` | string | Font Awesome icon style: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. | | `tag` | string | Label next to page title in sidebar (e.g., "NEW"). | | `hidden` | boolean | Remove from sidebar. Page still accessible by URL. Also excludes the page from search, sitemaps, external indexing, AI context, and `llms.txt`. Remove the field (or set `false`) to make a page visible again. | @@ -180,7 +180,7 @@ Single file or light/dark variants: } ``` -Options: `"fontawesome"` (default), `"lucide"`, or `"tabler"`. You can only use one library per project. Individual icons can still use URLs or file paths regardless of this setting. +Options: `"fontawesome"` (default), `"lucide"`, or `"tabler"`. You can only use one library per project. Individual icons can still use a single emoji, a URL, or a file path regardless of this setting. ## Fonts @@ -547,6 +547,8 @@ import { Counter } from "/snippets/counter.jsx"; JSX components can live in any directory, not just `/snippets/`. Nested imports between snippet files are not supported. +MDX expressions (imported variables like `{myName}` and inline expressions like `{1 + 1}`) are evaluated client-side in the browser. Their values are absent from a page's initial HTML and from offline exports, so crawlers, LLMs, and other tools that do not run JavaScript do not see them. Write values as plain text when they must be visible in those situations. + ## Hidden pages Set `hidden: true` in frontmatter to remove from sidebar. Page remains accessible by URL. From 1d7b3459a5520b29a825f7479c9b7a92354c06bb Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 12 Sep 2026 16:09:47 +0000 Subject: [PATCH 2/2] docs: tighten client-side MDX evaluation note --- .../context/skills/mintlify/reference/configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agent-context/context/skills/mintlify/reference/configuration.md b/agent-context/context/skills/mintlify/reference/configuration.md index 342d52d1f..06ef0a2b4 100644 --- a/agent-context/context/skills/mintlify/reference/configuration.md +++ b/agent-context/context/skills/mintlify/reference/configuration.md @@ -547,7 +547,7 @@ import { Counter } from "/snippets/counter.jsx"; JSX components can live in any directory, not just `/snippets/`. Nested imports between snippet files are not supported. -MDX expressions (imported variables like `{myName}` and inline expressions like `{1 + 1}`) are evaluated client-side in the browser. Their values are absent from a page's initial HTML and from offline exports, so crawlers, LLMs, and other tools that do not run JavaScript do not see them. Write values as plain text when they must be visible in those situations. +MDX expressions (imported variables like `{myName}` and inline expressions like `{1 + 1}`) are evaluated client-side. Their values are absent from a page's initial HTML and from offline exports. Crawlers, LLMs, and other tools that do not run JavaScript do not see them. Write values as plain text when they must be visible in those situations. ## Hidden pages