Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -27,10 +27,22 @@
"pages": [
"index",
"quickstart",
"features/capabilities",
"features/comparison",
"ai-native",
"migration"
]
},
{
"group": "Resources",
"icon": "book-open",
"pages": [
"resources/learning-hub",
"resources/whats-new",
"changelog",
"resources/support"
]
},
{
"group": "Organize",
"icon": "map",
Expand Down
189 changes: 189 additions & 0 deletions features/capabilities.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,189 @@
---
title: "Platform capabilities"
description: "Explore the powerful features that make Mintlify the best documentation platform"
---

## Core capabilities

<CardGroup cols={2}>
<Card title="Content creation" icon="pen-line">
### Write with ease

Create beautiful documentation using MDX, our web editor, or your favorite code editor. Support for Markdown, React components, and rich media.

**Key features:**
- Web-based editor with live preview
- Local CLI development
- 20+ interactive components
- Syntax highlighting for 100+ languages
- Image optimization and embeds
</Card>

<Card title="API documentation" icon="file-json">
### Auto-generated API docs

Transform OpenAPI and AsyncAPI specifications into beautiful, interactive API documentation automatically.

**Key features:**
- OpenAPI 3.0+ support
- AsyncAPI support
- Interactive API playground
- SDK code examples
- Request/response examples
</Card>

<Card title="AI-powered search" icon="sparkles">
### Intelligent assistance

Help users find answers instantly with AI-powered search and contextual assistance built into your documentation.

**Key features:**
- Semantic search
- AI assistant chat
- Contextual suggestions
- Multi-language support
- Custom training on your docs
</Card>

<Card title="Customization" icon="paint-bucket">
### Brand your docs

Make your documentation uniquely yours with extensive customization options and theming capabilities.

**Key features:**
- Custom themes and colors
- Custom fonts and typography
- Custom domain support
- Custom scripts and analytics
- React component integration
</Card>

<Card title="Deployment" icon="rocket">
### Deploy anywhere

Deploy your documentation with confidence using our global CDN or your preferred hosting provider.

**Key features:**
- GitHub/GitLab integration
- Preview deployments
- CI/CD support
- Global CDN
- Custom hosting options
</Card>

<Card title="Analytics" icon="chart-line">
### Understand your users

Track how users interact with your documentation and identify areas for improvement.

**Key features:**
- Page view analytics
- Search analytics
- User feedback collection
- Integration with analytics tools
- Custom event tracking
</Card>
</CardGroup>

## Advanced features

### Authentication & access control

Protect your documentation with flexible authentication options:

- **SSO integration** - SAML, OAuth, and custom providers

Check warning on line 94 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L94

Spell out 'SSO', if it's unfamiliar to the audience.

Check warning on line 94 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L94

Spell out 'SAML', if it's unfamiliar to the audience.
- **Role-based access** - Control who can view and edit content
- **Team management** - Invite and manage team members
- **Audit logs** - Track all changes and access

### Collaboration

Work together seamlessly:

- **Real-time collaboration** - Edit with your team simultaneously
- **Comments and feedback** - Discuss changes inline
- **Version control** - Git-based workflow with full history
- **Preview deployments** - Review changes before publishing

### Integrations

Connect with your favorite tools:

<CardGroup cols={3}>
<Card title="Analytics" icon="chart-bar" href="/integrations/analytics/overview">
Google Analytics, Mixpanel, Amplitude, and more
</Card>
<Card title="Support" icon="life-ring" href="/integrations/support/overview">
Intercom, Front, and other support tools
</Card>
<Card title="SDKs" icon="code" href="/integrations/sdks/speakeasy">
Speakeasy and Stainless SDK generation
</Card>
</CardGroup>

## AI capabilities

### AI assistant

Embed an intelligent assistant directly in your documentation:

- Answer questions based on your content
- Provide contextual help
- Support multiple languages
- Customize responses and behavior

[Learn more about AI assistant →](/ai/assistant)

### Agent workflows

Automate documentation tasks with AI agents:

- Auto-generate documentation from code
- Keep docs in sync with codebase
- Suggest improvements
- Answer questions in Slack/Discord

[Explore agent workflows →](/agent/index)

### Model Context Protocol

Check warning on line 148 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L148

'Model Context Protocol' should use sentence-style capitalization.

Integrate with AI development tools:

- Claude Code integration
- Cursor IDE support
- Windsurf compatibility
- Custom MCP servers

[Read about MCP →](/ai/model-context-protocol)

## Performance & reliability

### Global infrastructure

- **CDN delivery** - Fast loading worldwide

Check warning on line 163 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L163

Spell out 'CDN', if it's unfamiliar to the audience.

Check warning on line 163 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L163

Use 'cdn' instead of 'CDN'.
- **99.9% uptime** - Enterprise SLA available

Check warning on line 164 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L164

Spell out 'SLA', if it's unfamiliar to the audience.
- **Automatic scaling** - Handle traffic spikes
- **SSL certificates** - Automatic HTTPS

Check warning on line 166 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L166

Use 'ssl' instead of 'SSL'.

Check warning on line 166 in features/capabilities.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/capabilities.mdx#L166

Use 'https' instead of 'HTTPS'.

### SEO optimization

Built-in SEO features to help users find your docs:

- Automatic sitemap generation
- Meta tag optimization
- Structured data markup
- Fast page loads
- Mobile-responsive design

[SEO best practices →](/guides/seo)

## Getting started

<CardGroup cols={2}>
<Card title="Try it free" icon="rocket" href="/quickstart">
Start building your documentation in minutes
</Card>
<Card title="View all features" icon="list" href="/features/comparison">
Compare plans and features
</Card>
</CardGroup>
73 changes: 73 additions & 0 deletions features/comparison.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: "Feature comparison"
description: "Compare Mintlify plans and features to find the right fit for your team"
---

## Plans overview

Choose the plan that best fits your documentation needs.

| Feature | Starter | Growth | Enterprise |
|---------|---------|--------|------------|
| **Pages** | Up to 100 | Unlimited | Unlimited |
| **Team members** | 3 | 10 | Unlimited |
| **Custom domain** | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |
| **AI assistant** | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |
| **Analytics** | Basic | Advanced | Advanced |
| **API playground** | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |
| **Authentication** | <Icon icon="x" iconType="solid" /> | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |
| **SSO** | <Icon icon="x" iconType="solid" /> | <Icon icon="x" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |

Check warning on line 19 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L19

Spell out 'SSO', if it's unfamiliar to the audience.
| **Priority support** | <Icon icon="x" iconType="solid" /> | <Icon icon="check" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |
| **SLA** | <Icon icon="x" iconType="solid" /> | <Icon icon="x" iconType="solid" /> | <Icon icon="check" iconType="solid" /> |

Check warning on line 21 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L21

Spell out 'SLA', if it's unfamiliar to the audience.

## Core capabilities

### Content creation

Build beautiful documentation with our comprehensive toolset:

Check warning on line 27 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L27

Did you really mean 'toolset'?

- **Web editor** - Browser-based editing with live preview
- **CLI development** - Local development with hot reload
- **MDX support** - Write in Markdown with React components
- **Component library** - 20+ pre-built interactive components
- **Code blocks** - Syntax highlighting for 100+ languages
- **API documentation** - Auto-generate from OpenAPI/AsyncAPI specs

### AI-powered features

Enhance your documentation with AI capabilities:

- **AI assistant** - Contextual answers from your docs
- **Smart search** - Semantic search across all content
- **Auto-suggestions** - AI-powered content recommendations
- **Agent workflows** - Automate documentation tasks

### Deployment & hosting

Deploy with confidence:

- **Global CDN** - Fast loading worldwide

Check warning on line 49 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L49

Spell out 'CDN', if it's unfamiliar to the audience.

Check warning on line 49 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L49

Use 'cdn' instead of 'CDN'.
- **Preview deployments** - Test changes before going live
- **GitHub/GitLab integration** - Deploy from your repository
- **Custom domains** - Use your own domain
- **SSL certificates** - Automatic HTTPS

Check warning on line 53 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L53

Use 'ssl' instead of 'SSL'.

Check warning on line 53 in features/comparison.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

features/comparison.mdx#L53

Use 'https' instead of 'HTTPS'.

### Analytics & insights

Understand your users:

- **Page views** - Track documentation usage
- **Search analytics** - See what users are looking for
- **User feedback** - Collect ratings and comments
- **Integration support** - Connect to Google Analytics, Mixpanel, and more

## Getting started

<CardGroup cols={2}>
<Card title="Start free trial" icon="rocket" href="/quickstart">
Deploy your first docs site in minutes
</Card>
<Card title="View pricing" icon="credit-card" href="https://mintlify.com/pricing">
Compare plans and pricing details
</Card>
</CardGroup>
35 changes: 35 additions & 0 deletions index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,8 @@
</h3>
<span className="mt-1.5">{description}</span>
</a>
);

Check warning on line 24 in index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

index.mdx#L24

Use semicolons judiciously.
};

Check warning on line 25 in index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

index.mdx#L25

Use semicolons judiciously.

<div className="relative">
<div className="absolute -top-14 left-0 right-0 opacity-80">
Expand All @@ -47,6 +47,15 @@
Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers and teams.
</div>

<div className="flex justify-center gap-4 mt-8">
<a href="/quickstart" className="px-6 py-3 bg-primary text-white rounded-lg font-medium hover:opacity-90 transition-opacity">
Get started
</a>
<a href="/features/comparison" className="px-6 py-3 border border-gray-300 dark:border-zinc-700 rounded-lg font-medium hover:bg-gray-50 dark:hover:bg-zinc-800 transition-colors">
Compare features
</a>
</div>

<div className="px-6 lg:px-0 mt-12 lg:mt-24 grid sm:grid-cols-2 gap-x-6 gap-y-4">
<HeroCard filename="rocket" title="Quickstart" description="Deploy your first docs site in minutes with our step-by-step guide" href="/quickstart" />

Expand All @@ -71,5 +80,31 @@
href="/components/accordions"
/>
</div>

<div className="px-6 lg:px-0 mt-16 lg:mt-24">
<h2 className="text-2xl font-medium text-center text-gray-900 dark:text-zinc-50 mb-8">
Explore Mintlify
</h2>

<div className="grid sm:grid-cols-3 gap-6">
<a href="/features/capabilities" className="group p-6 border border-gray-200 dark:border-zinc-800 rounded-lg hover:border-primary transition-colors">
<div className="text-3xl mb-3">✨</div>
<h3 className="text-lg font-medium text-gray-900 dark:text-zinc-50 mb-2">Platform capabilities</h3>
<p className="text-sm text-gray-600 dark:text-zinc-400">Discover powerful features for creating exceptional documentation</p>
</a>

<a href="/resources/learning-hub" className="group p-6 border border-gray-200 dark:border-zinc-800 rounded-lg hover:border-primary transition-colors">
<div className="text-3xl mb-3">📚</div>
<h3 className="text-lg font-medium text-gray-900 dark:text-zinc-50 mb-2">Learning hub</h3>
<p className="text-sm text-gray-600 dark:text-zinc-400">Tutorials, guides, and resources to help you master Mintlify</p>
</a>

<a href="/resources/whats-new" className="group p-6 border border-gray-200 dark:border-zinc-800 rounded-lg hover:border-primary transition-colors">
<div className="text-3xl mb-3">🎉</div>
<h3 className="text-lg font-medium text-gray-900 dark:text-zinc-50 mb-2">What's new</h3>
<p className="text-sm text-gray-600 dark:text-zinc-400">Latest features, updates, and improvements to the platform</p>
</a>
</div>
</div>
</div>
</div>
Loading
Loading