Migrate from Mintlify
DocsLit can automatically convert a Mintlify documentation project. The import command reads your mint.json, converts MDX components to DocsLit equivalents, and generates a ready-to-use project.
Run the migration
This creates a {{MINTLIFY_DIR}}-docslit/ directory with your converted documentation.
What gets converted
The import command handles these transformations automatically:
Component mapping
Other transformations
- MDX imports and exports — Stripped automatically
- JSX props — Converted to HTML attributes
- Font Awesome icons — Mapped to built-in Lucide equivalents (50+ mappings)
- Sidebar structure — Generated from
mint.jsonnavigation - Static assets — Copied to the output directory
After migration
The import prints a report showing converted pages, items needing manual review, and any errors.
Preview every page and check that components render correctly.
This catches broken links, missing pages, and unknown component tags.
Some components do not have a direct equivalent and need manual attention. The import report flags these as "needs review".