From f9ec1d900ed6467fcb0bcedf5c31fb1fdeb6e553 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 9 Sep 2026 16:10:54 +0000 Subject: [PATCH] docs: sync agent skill with className, MDX code, and CLI updates --- .../context/skills/mintlify/reference/cli.md | 12 ++++++------ .../context/skills/mintlify/reference/components.md | 7 +++++++ .../skills/mintlify/reference/configuration.md | 2 +- 3 files changed, 14 insertions(+), 7 deletions(-) diff --git a/agent-context/context/skills/mintlify/reference/cli.md b/agent-context/context/skills/mintlify/reference/cli.md index 288bcff62..d922665cd 100644 --- a/agent-context/context/skills/mintlify/reference/cli.md +++ b/agent-context/context/skills/mintlify/reference/cli.md @@ -2,7 +2,7 @@ Condensed reference for common `mint` CLI commands and their key flags. -Install with `npm i -g mint`. +Install with `npm i -g mint`. The npm package is `mint`; do not install the legacy `mintlify` package. ## Global flags @@ -10,15 +10,15 @@ Available on all commands. | Flag | Description | |------|-------------| -| `--telemetry`, `-t` | Enable or disable anonymous usage telemetry. | +| `--telemetry`, `-t` | Enable or disable usage telemetry. | | `--help`, `-h` | Display help for the command. | | `--version`, `-v` | Display the CLI version. Alias for `mint version`. | ## Local development -- `mint dev` — Start local preview at localhost:3000. `--port` sets the port. `--no-open` skips browser launch. `--groups ` mocks user groups. `--disable-openapi` skips OpenAPI processing. `--disable-prefetch` disables navigation prefetching. `--local-schema` allows locally-hosted OpenAPI files over HTTP. -- `mint validate` — Strict build validation; exits non-zero on warnings or errors. `--groups ` mocks user groups. `--disable-openapi` skips OpenAPI processing. `--local-schema` allows local OpenAPI files. -- `mint export` — Export a static site zip for air-gapped deployment. `--output ` sets the output path (default: `export.zip`). `--groups ` includes restricted pages. `--disable-openapi` skips OpenAPI processing. +- `mint dev` — Start local preview at localhost:3000. `--port` sets the port. `--no-open` skips browser launch. `--groups` mocks user groups (space-separated, e.g. `--groups admin user`). `--disable-openapi` skips OpenAPI processing. `--disable-prefetch` disables navigation prefetching. `--local-schema` allows locally-hosted OpenAPI files over HTTP. +- `mint validate` — Strict build validation; exits non-zero on warnings or errors. `--groups` mocks user groups (space-separated). `--disable-openapi` skips OpenAPI processing. `--local-schema` allows local OpenAPI files. +- `mint export` — Export a static site zip for air-gapped deployment. `--output ` sets the output path (default: `export.zip`). `--groups` includes restricted pages (space-separated). `--disable-openapi` skips OpenAPI processing. ## Content quality @@ -93,7 +93,7 @@ All `mint automations` subcommands share these flags: `--subdomain`, `--format` ## Telemetry -The CLI collects anonymous usage telemetry by default. Opt out with `--telemetry false` or by setting either environment variable: +The CLI collects usage telemetry by default (command name, CLI version, OS, architecture). When you are logged in, telemetry events also include your account email; logged-out usage stays anonymous. Opt out with `--telemetry false` or by setting either environment variable: | Variable | Value | Description | |----------|-------|-------------| diff --git a/agent-context/context/skills/mintlify/reference/components.md b/agent-context/context/skills/mintlify/reference/components.md index 29fe96b48..738467a4b 100644 --- a/agent-context/context/skills/mintlify/reference/components.md +++ b/agent-context/context/skills/mintlify/reference/components.md @@ -2,6 +2,12 @@ Full syntax and props for all Mintlify components. +## Styling with className + +All built-in components accept a `className` prop (string) except Banner, MDX, and Visibility. Mintlify merges your classes with the component's own styles. Use Tailwind CSS v3 classes, including arbitrary values such as `w-[350px]`, or class names defined in a custom CSS file. Write class names out in full. Mintlify generates CSS only for class names found in the page source, so runtime-assembled names like `` bg-${color}-500 `` produce no CSS. On ``, `className` styles the tab's content panel, not its label in the tab bar. + +Component `title` props (for example on Accordion, Step, and Tab) support inline Markdown formatting such as `**bold**`, `_italic_`, and `` `code` ``. + ## Callouts Styled alert boxes for important information. @@ -424,6 +430,7 @@ Notes: - Block form at the top level of a page: leave a blank line after the opening tag so content parses as block-level Markdown. - Inside expressions, `` strips the common leading indentation from its content. - Headings inside `` appear in the page's table of contents, including headings in branches that never render (such as the inactive side of a conditional). +- Code fences and inline code inside `` compile like code at the page root. Raw `<`, `>`, `{`, and `}` need no escaping. Character references decode to their characters (`<` renders as `<`; write `&lt;` for a literal `<`). - Limits: nest `` up to 8 levels deep; a page can expand up to 500 `` fragments inside expressions. Exceeding either limit fails the build. ## Panel diff --git a/agent-context/context/skills/mintlify/reference/configuration.md b/agent-context/context/skills/mintlify/reference/configuration.md index 4542e43df..b8ccc7b80 100644 --- a/agent-context/context/skills/mintlify/reference/configuration.md +++ b/agent-context/context/skills/mintlify/reference/configuration.md @@ -587,7 +587,7 @@ Add `.css` files to your repository. Class names become available in all MDX fil } ``` -Built-in Tailwind CSS v3 classes are available. Arbitrary values (e.g., `w-[350px]`) are not supported — use inline `style` instead. +Built-in Tailwind CSS v3 classes are available, including arbitrary values (e.g., `w-[350px]`) and variants (`sm:`, `hover:`, `dark:`). All built-in components except Banner, MDX, and Visibility accept a `className` prop. Write class names out in full: Mintlify generates CSS only for class names found in the page source, so runtime-assembled names produce no CSS. Avoid the inline `style` prop; it can cause layout shift on page load. ### JavaScript