Issues

• Question about MCP config usage in this repo (research)

  mintlify/docs#7566 · Filter by author Paraphern opened on Sep 29, 2026

• mint releases are published before their pinned @mintlify/* dependencies, so npm install -g mint fails with ETARGET for up to ~5 minutes after every release

  mintlify/docs#7366 · Filter by author NathanEckert opened on Sep 15, 2026

• Docs describe iconType on docs.json objects, which the schema rejects

  mintlify/docs#7332 · Filter by author AgLyx3 opened on Sep 10, 2026

• Server card omits submit_feedback: advertised tool list is missing a tool the endpoint serves (50/51 sites checked)

  mintlify/docs#7313 · Filter by author he110 opened on Sep 9, 2026
  2

• Performance: fixed ~700KB client bundle with no way to disable unused features or add LCP hints

  mintlify/docs#7195 · Filter by author wislertt opened on Aug 31, 2026

• AsyncAPI spec silently fails to load when spec produces info/warning diagnostics (e.g. AsyncAPI 3.0.0)

  mintlify/docs#7140 · Filter by author asc-netlight opened on Aug 27, 2026

• Preview domain canonical URLs drop the custom domain's base path ("Host at /docs"), advertising 404 URLs to AI crawlers

  mintlify/docs#6663 · Filter by author vishnukool opened on Jul 20, 2026

• properties containing $ get dereferenced in examples

  mintlify/docs#6235 · Filter by author audy opened on Jun 19, 2026

• Newly-added PDF assets 404 on the live site (older PDFs serve fine)

  mintlify/docs#6186 · Filter by author Jesse-Sawa opened on Jun 15, 2026

• Auto-generated skill.md frontmatter is invalid YAML (unquoted description with a colon) - breaks npx skills add

  mintlify/docs#6061 · Filter by author ahmad-wzk opened on Jun 3, 2026

• Hosted favicons are all media-gated (prefers-color-scheme) with no plain fallback → Safari shows letter tile

  mintlify/docs#6040 · Filter by author jmfoster opened on May 31, 2026

• MCP server does not expose proper favicon/icon

  mintlify/docs#5897 · Filter by author notgiorgi opened on May 22, 2026

• The favicon of sites built with Mintlify is perpetually rendered with rounded corners in Google search results.

  mintlify/docs#5804 · Filter by author tianyuan-ai opened on May 14, 2026

• [feature] Mermaid - zoom to fill screen

  mintlify/docs#5751 · Filter by author markmandel opened on May 11, 2026

• OpenAPI 3.1.0 webhooks key not server-side rendered

  mintlify/docs#5712 · Filter by author RichardBray opened on May 8, 2026

• mint broken-links: Windows-only false positives, broken stdout redirect, and mojibake (CLI v4.2.549)

  mintlify/docs#5680 · Filter by author gandalf-at-lerian opened on May 6, 2026
  1

• Bump tar dependency from 6.1.15 to 7.x in @mintlify/previewing (security)

  mintlify/docs#5659 · Filter by author ewenneborg opened on May 4, 2026
  1

• Snippet imports silently fail with 'Could not parse import/exports with acorn' when snippet has // or inline {/* */} comments in function body

  mintlify/docs#5655 · Filter by author brianjohnson0123 opened on May 3, 2026
  1

• mintlify dev fails with "Client not built" on macOS arm64 — npm tar@6.1.15 silently skips .next/ directory during extraction

  mintlify/docs#5624 · Filter by author TurekBot opened on May 1, 2026
  1

• broken-links --check-anchors misses invalid colon anchors

  mintlify/docs#5537 · Filter by author JuroUhlar opened on Apr 27, 2026

• [Repository URL resolve] try main branch instead of master branch

  mintlify/docs#5534 · Filter by author 321paranoiawhy opened on Apr 27, 2026
  1

• Unpublished article (404) got added to sitemap - bug?

  mintlify/docs#5408 · Filter by author ashishguptaiitb opened on Apr 16, 2026

• mint@4.2.469: keytar dependency breaks headless CI (openapi-check)

  mintlify/docs#5077 · Filter by author veganbeef opened on Apr 1, 2026
  3

• Onboarding: Clone URL uses HTTPS which fails for push

  mintlify/docs#4921 · Filter by author styltsou opened on Mar 26, 2026

• Missing docs - Canonical URL path is incorrect in local build

  mintlify/docs#4899 · Filter by author ashishguptaiitb opened on Mar 26, 2026
  1