Offline export

Export your documentation site as a self-contained zip archive for offline viewing and distribution.

Use mint export to package your entire documentation site into a self-contained zip archive. Recipients can unzip and view the docs in their browser without an internet connection, a Mintlify account, or any build tools — they only need Node.js installed.

This is useful when you need to distribute documentation to users who can’t access your live site, such as for on-premise customers, air-gapped environments, or internal compliance reviews.

Prerequisites

• The CLI installed and up to date
• Node.js v20.17.0+ installed

Export your site

Navigate to your documentation directory containing your docs.json file and run:

mint export

The CLI builds your site, crawls every page defined in your navigation, and packages the output into a zip file in your current directory.

What’s in the zip

The exported archive contains everything needed to view your docs offline:

File	Purpose
HTML pages	Pre-rendered version of every page in your navigation
_next/static/	Bundled CSS, JavaScript, and other static assets
serve.js	Zero-dependency Node.js HTTP server that serves the site
Start Docs.command	macOS launcher — double-click to open the docs
Start Docs.bat	Windows launcher — double-click to open the docs

View the exported docs

Share the zip file with anyone who has Node.js installed. To view the docs:

macOS

1. Unzip the archive.
2. Double-click Start Docs.command.
3. The docs open in your default browser at http://localhost:3000.

macOS Gatekeeper may block the file because it was downloaded from the internet. To allow it, right-click (or Control-click) Start Docs.command and select Open, then select Open again in the confirmation dialog. You only need to do this once per file.

Windows

1. Unzip the archive.
2. Double-click Start Docs.bat.
3. The docs open in your default browser at http://localhost:3000.

Windows SmartScreen may block the file because it was downloaded from the internet. You can unblock it in one of two ways:

• From the SmartScreen prompt: Select More info, then select Run anyway.
• From file properties: Right-click Start Docs.bat, select Properties, check the Unblock checkbox in the Security section, then select Apply.

Manual

1. Unzip the archive.
2. Open a terminal in the unzipped directory.
3. Run node serve.js.
4. Open http://localhost:3000 in your browser.