From 2c3ce0f63cb58a1f90b4b8238a76135c98991b6e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 24 Mar 2026 20:40:39 +0000 Subject: [PATCH 1/2] Document build/ as reserved directory for static files Generated-By: mintlify-agent --- create/files.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/create/files.mdx b/create/files.mdx index 7ba6f9a51..c7512b72c 100644 --- a/create/files.mdx +++ b/create/files.mdx @@ -32,6 +32,14 @@ Supported file types for Enterprise plans: - **Data**: `.xml`, `.csv` - **Archives**: `.zip` +## Reserved directory names + +Certain directory names are reserved and cannot be used for serving static files. Files placed in these directories may work locally but will not be accessible in production: + +- `build/` + +Rename these directories to avoid conflicts. For example, use `build-assets/` or `build-output/` instead of `build/`. + ## File organization Organize your files using folders to keep your repository easy to navigate: From 6d48374598f10caa42e5f4822abd3749e7a6fad1 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 24 Mar 2026 14:54:54 -0700 Subject: [PATCH 2/2] update default ignored patterns --- create/files.mdx | 8 -------- organize/mintignore.mdx | 7 +++++++ 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/create/files.mdx b/create/files.mdx index c7512b72c..7ba6f9a51 100644 --- a/create/files.mdx +++ b/create/files.mdx @@ -32,14 +32,6 @@ Supported file types for Enterprise plans: - **Data**: `.xml`, `.csv` - **Archives**: `.zip` -## Reserved directory names - -Certain directory names are reserved and cannot be used for serving static files. Files placed in these directories may work locally but will not be accessible in production: - -- `build/` - -Rename these directories to avoid conflicts. For example, use `build-assets/` or `build-output/` instead of `build/`. - ## File organization Organize your files using folders to keep your repository easy to navigate: diff --git a/organize/mintignore.mdx b/organize/mintignore.mdx index 83792f4f7..9a7501675 100644 --- a/organize/mintignore.mdx +++ b/organize/mintignore.mdx @@ -43,7 +43,14 @@ Mintlify automatically ignores the following directories and files without requi - `.claude` - `.agents` - `.idea` +- `.vscode` - `node_modules` +- `build` +- `dist` +- `coverage` +- `.cache` +- `tmp` +- `temp` - `README.md` - `LICENSE.md` - `CHANGELOG.md`