From 447df55c8d2e02204434127a55cc4f68d86d165b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 27 Jul 2026 23:24:45 +0000 Subject: [PATCH 1/2] docs: document mint dev --disable-prefetch flag --- cli/commands.mdx | 1 + cli/preview.mdx | 12 ++++++++++++ 2 files changed, 13 insertions(+) diff --git a/cli/commands.mdx b/cli/commands.mdx index 4525297e47..3c900ac2e2 100644 --- a/cli/commands.mdx +++ b/cli/commands.mdx @@ -30,6 +30,7 @@ mint dev [flags] | `--no-open` | Do not open the browser automatically. | | `--groups` | Comma-separated list of user groups to mock for preview. | | `--disable-openapi` | Skip OpenAPI file processing to improve performance. | +| `--disable-prefetch` | Disable navigation prefetching in the local preview. Useful for very large sites where background prefetching slows down page loads. | | `--local-schema` | Allow locally hosted OpenAPI files served over HTTP. | --- diff --git a/cli/preview.mdx b/cli/preview.mdx index 28792f53e2..da2ffa4040 100644 --- a/cli/preview.mdx +++ b/cli/preview.mdx @@ -73,6 +73,18 @@ If you have many OpenAPI files, skip OpenAPI processing during local development mint dev --disable-openapi ``` +## Disable navigation prefetching + +By default, the local preview prefetches nearby pages so that navigating between them feels instant. For very large sites, this can slow down the page you are actively viewing because many pages compile in the background at the same time. + +If you have thousands of pages and notice slow page loads during local preview, disable prefetching with the `--disable-prefetch` flag: + +```bash +mint dev --disable-prefetch +``` + +With prefetching disabled, pages compile only when you navigate to them. Individual page loads take longer than a prefetched page, but the page you request is not competing with background compilation. + ## Preview as a specific group If you use group-based access control, preview as a specific authentication group with the `--groups` flag: From 8cfce77cb8d10b61bfbd76dce075bda4fe007a4d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 27 Jul 2026 23:26:49 +0000 Subject: [PATCH 2/2] docs: translate --disable-prefetch flag to es, fr, zh --- es/cli/commands.mdx | 1 + es/cli/preview.mdx | 14 ++++++++++++++ fr/cli/commands.mdx | 1 + fr/cli/preview.mdx | 14 ++++++++++++++ zh/cli/commands.mdx | 1 + zh/cli/preview.mdx | 14 ++++++++++++++ 6 files changed, 45 insertions(+) diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx index a3d644d762..40b3fd6621 100644 --- a/es/cli/commands.mdx +++ b/es/cli/commands.mdx @@ -34,6 +34,7 @@ mint dev [flags] | `--no-open` | No abrir el navegador automáticamente. | | `--groups` | Lista separada por comas de grupos de usuarios a simular para la previsualización. | | `--disable-openapi` | Omitir el procesamiento de archivos OpenAPI para mejorar el rendimiento. | +| `--disable-prefetch` | Deshabilitar la precarga de navegación en la vista previa local. Útil para sitios muy grandes donde la precarga en segundo plano ralentiza la carga de páginas. | | `--local-schema` | Permitir archivos OpenAPI alojados localmente servidos por HTTP. | --- diff --git a/es/cli/preview.mdx b/es/cli/preview.mdx index b6e46919ae..d8dd74d91d 100644 --- a/es/cli/preview.mdx +++ b/es/cli/preview.mdx @@ -83,6 +83,20 @@ Si tienes muchos archivos OpenAPI, omite el procesamiento de OpenAPI durante el mint dev --disable-openapi ``` +
+ ## Deshabilitar la precarga de navegación +
+ +De forma predeterminada, la vista previa local precarga las páginas cercanas para que la navegación entre ellas se sienta instantánea. En sitios muy grandes, esto puede ralentizar la página que estás viendo, porque muchas páginas se compilan en segundo plano al mismo tiempo. + +Si tienes miles de páginas y notas cargas de página lentas durante la vista previa local, deshabilita la precarga con el flag `--disable-prefetch`: + +```bash +mint dev --disable-prefetch +``` + +Con la precarga deshabilitada, las páginas se compilan solo cuando navegas a ellas. Las cargas de página individuales tardan más que una página precargada, pero la página que solicitas no compite con la compilación en segundo plano. +
## Previsualizar como un grupo específico
diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx index 215367fed9..eb5d9162d5 100644 --- a/fr/cli/commands.mdx +++ b/fr/cli/commands.mdx @@ -34,6 +34,7 @@ mint dev [flags] | `--no-open` | Ne pas ouvrir le navigateur automatiquement. | | `--groups` | Liste séparée par des virgules de groupes d'utilisateurs à simuler pour la prévisualisation. | | `--disable-openapi` | Ignorer le traitement des fichiers OpenAPI pour améliorer les performances. | +| `--disable-prefetch` | Désactiver le préchargement de la navigation dans la prévisualisation locale. Utile pour les très grands sites où le préchargement en arrière-plan ralentit le chargement des pages. | | `--local-schema` | Autoriser les fichiers OpenAPI hébergés localement servis via HTTP. | --- diff --git a/fr/cli/preview.mdx b/fr/cli/preview.mdx index 845ab35d30..ec63f517f4 100644 --- a/fr/cli/preview.mdx +++ b/fr/cli/preview.mdx @@ -83,6 +83,20 @@ Si vous avez de nombreux fichiers OpenAPI, ignorez le traitement OpenAPI pendant mint dev --disable-openapi ``` +
+ ## Désactiver le préchargement de la navigation +
+ +Par défaut, la prévisualisation locale précharge les pages voisines pour que la navigation entre elles semble instantanée. Sur les très grands sites, cela peut ralentir la page que vous consultez, car de nombreuses pages sont compilées en arrière-plan en même temps. + +Si vous avez des milliers de pages et constatez des chargements de page lents lors de la prévisualisation locale, désactivez le préchargement avec le flag `--disable-prefetch` : + +```bash +mint dev --disable-prefetch +``` + +Avec le préchargement désactivé, les pages ne sont compilées que lorsque vous y accédez. Les chargements de page individuels prennent plus de temps qu'une page préchargée, mais la page que vous demandez n'est pas en concurrence avec la compilation en arrière-plan. +
## Prévisualiser en tant que groupe spécifique
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx index da8b682719..5e24f950bb 100644 --- a/zh/cli/commands.mdx +++ b/zh/cli/commands.mdx @@ -34,6 +34,7 @@ mint dev [flags] | `--no-open` | 不自动打开浏览器。 | | `--groups` | 以逗号分隔的用户组列表，用于模拟预览。 | | `--disable-openapi` | 跳过 OpenAPI 文件处理以提高性能。 | +| `--disable-prefetch` | 在本地预览中禁用导航预加载。适用于后台预加载会拖慢页面加载的超大型站点。 | | `--local-schema` | 允许通过 HTTP 提供的本地托管 OpenAPI 文件。 | --- diff --git a/zh/cli/preview.mdx b/zh/cli/preview.mdx index 42ce008827..6f4577e773 100644 --- a/zh/cli/preview.mdx +++ b/zh/cli/preview.mdx @@ -83,6 +83,20 @@ mint dev --port 3333 mint dev --disable-openapi ``` +
+ ## 禁用导航预加载 +
+ +默认情况下，本地预览会预加载附近的页面，让页面之间的导航感觉是瞬时的。对于非常大的站点，这可能会拖慢你当前正在查看的页面，因为许多页面同时在后台编译。 + +如果你有数千个页面，并且注意到本地预览时页面加载缓慢，可以使用 `--disable-prefetch` 选项禁用预加载： + +```bash +mint dev --disable-prefetch +``` + +禁用预加载后，页面只会在你导航到它们时才会编译。单个页面加载时间会比预加载的页面更长，但你请求的页面不会与后台编译争抢资源。 +
## 以特定组预览