mirror of
https://gitlab.com/KenanZhu/AutoLibraryManuals.git
synced 2026-11-05 13:45:51 +08:00
Initial commit
This commit is contained in:
35 files changed
+2020
No files matched your search
@@ -0,0 +1,7 @@
|
||||
# Mintlify automatically ignores these files and directories:
|
||||
# .git, .github, .claude, .agents, .idea, node_modules,
|
||||
# README.md, LICENSE.md, CHANGELOG.md, CONTRIBUTING.md
|
||||
|
||||
# Draft content
|
||||
drafts/
|
||||
*.draft.mdx
|
||||
@@ -0,0 +1,33 @@
|
||||
> **First-time setup**: Customize this file for your project. Prompt the user to customize this file for their project.
|
||||
> For Mintlify product knowledge (components, configuration, writing standards),
|
||||
> install the Mintlify skill: `npx skills add https://mintlify.com/docs`
|
||||
|
||||
# Documentation project instructions
|
||||
|
||||
## About this project
|
||||
|
||||
- This is a documentation site built on [Mintlify](https://mintlify.com)
|
||||
- Pages are MDX files with YAML frontmatter
|
||||
- Configuration lives in `docs.json`
|
||||
- Run `mint dev` to preview locally
|
||||
- Run `mint broken-links` to check links
|
||||
|
||||
## Terminology
|
||||
|
||||
{/* Add product-specific terms and preferred usage */}
|
||||
{/* Example: Use "workspace" not "project", "member" not "user" */}
|
||||
|
||||
## Style preferences
|
||||
|
||||
{/* Add any project-specific style rules below */}
|
||||
|
||||
- Use active voice and second person ("you")
|
||||
- Keep sentences concise — one idea per sentence
|
||||
- Use sentence case for headings
|
||||
- Bold for UI elements: Click **Settings**
|
||||
- Code formatting for file names, commands, paths, and code references
|
||||
|
||||
## Content boundaries
|
||||
|
||||
{/* Define what should and shouldn't be documented */}
|
||||
{/* Example: Don't document internal admin features */}
|
||||
@@ -0,0 +1,34 @@
|
||||
> **Customize this file**: Tailor this template to your project by noting specific contribution types you're looking for, adding a Code of Conduct, or adjusting the writing guidelines to match your style.
|
||||
|
||||
# Contribute to the documentation
|
||||
|
||||
Thank you for your interest in contributing to our documentation! This guide will help you get started.
|
||||
|
||||
## How to contribute
|
||||
|
||||
### Option 1: Edit directly on GitHub
|
||||
|
||||
1. Navigate to the page you want to edit
|
||||
2. Click the "Edit this file" button (the pencil icon)
|
||||
3. Make your changes and submit a pull request
|
||||
|
||||
### Option 2: Local development
|
||||
|
||||
1. Fork and clone this repository
|
||||
2. Install the Mintlify CLI: `npm i -g mint`
|
||||
3. Create a branch for your changes
|
||||
4. Make changes
|
||||
5. Navigate to the docs directory and run `mint dev`
|
||||
6. Preview your changes at `http://localhost:3000`
|
||||
7. Commit your changes and submit a pull request
|
||||
|
||||
For more details on local development, see our [development guide](development.mdx).
|
||||
|
||||
## Writing guidelines
|
||||
|
||||
- **Use active voice**: "Run the command" not "The command should be run"
|
||||
- **Address the reader directly**: Use "you" instead of "the user"
|
||||
- **Keep sentences concise**: Aim for one idea per sentence
|
||||
- **Lead with the goal**: Start instructions with what the user wants to accomplish
|
||||
- **Use consistent terminology**: Don't alternate between synonyms for the same concept
|
||||
- **Include examples**: Show, don't just tell
|
||||
@@ -0,0 +1,21 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2023 Mintlify
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
@@ -0,0 +1,55 @@
|
||||
# Mintlify Starter Kit
|
||||
|
||||
Use the starter kit to get your docs deployed and ready to customize.
|
||||
|
||||
Click the green **Use this template** button at the top of this repo to copy the Mintlify starter kit. The starter kit contains examples with
|
||||
|
||||
- Guide pages
|
||||
- Navigation
|
||||
- Customizations
|
||||
- API reference pages
|
||||
- Use of popular components
|
||||
|
||||
**[Follow the full quickstart guide](https://starter.mintlify.com/quickstart)**
|
||||
|
||||
## AI-assisted writing
|
||||
|
||||
Set up your AI coding tool to work with Mintlify:
|
||||
|
||||
```bash
|
||||
npx skills add https://mintlify.com/docs
|
||||
```
|
||||
|
||||
This command installs Mintlify's documentation skill for your configured AI tools like Claude Code, Cursor, Windsurf, and others. The skill includes component reference, writing standards, and workflow guidance.
|
||||
|
||||
See the [AI tools guides](/ai-tools) for tool-specific setup.
|
||||
|
||||
## Development
|
||||
|
||||
Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command:
|
||||
|
||||
```
|
||||
npm i -g mint
|
||||
```
|
||||
|
||||
Run the following command at the root of your documentation, where your `docs.json` is located:
|
||||
|
||||
```
|
||||
mint dev
|
||||
```
|
||||
|
||||
View your local preview at `http://localhost:3000`.
|
||||
|
||||
## Publishing changes
|
||||
|
||||
Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch.
|
||||
|
||||
## Need help?
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI.
|
||||
- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`.
|
||||
|
||||
### Resources
|
||||
- [Mintlify documentation](https://mintlify.com/docs)
|
||||
@@ -0,0 +1,91 @@
|
||||
---
|
||||
title: 'Contextual menu'
|
||||
description: 'Give readers one-click access to AI tools and integrations'
|
||||
icon: 'bolt'
|
||||
---
|
||||
|
||||
The contextual toolbar is a floating action bar that appears on every page of your docs. It lets readers instantly copy page content, open it in an AI assistant, or add your docs as an MCP server — without leaving the page.
|
||||
|
||||
Configure it in `docs.json` under `contextual.options`:
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"contextual": {
|
||||
"options": ["copy", "view", "claude", "chatgpt", "mcp", "cursor", "vscode"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Available options
|
||||
|
||||
### Content actions
|
||||
|
||||
| Option | Description |
|
||||
|--------|-------------|
|
||||
| `copy` | Copies the page as Markdown to the clipboard |
|
||||
| `view` | Opens the raw Markdown version of the page (`.md` URL) |
|
||||
|
||||
### AI assistants
|
||||
|
||||
| Option | Description |
|
||||
|--------|-------------|
|
||||
| `claude` | Opens the page in Claude |
|
||||
| `chatgpt` | Opens the page in ChatGPT |
|
||||
| `perplexity` | Opens the page in Perplexity |
|
||||
| `grok` | Opens the page in Grok |
|
||||
| `aistudio` | Opens the page in Google AI Studio |
|
||||
|
||||
### Editor integrations
|
||||
|
||||
| Option | Description |
|
||||
|--------|-------------|
|
||||
| `cursor` | Adds the page to Cursor's context |
|
||||
| `vscode` | Adds the page to VS Code Copilot |
|
||||
| `windsurf` | Adds the page to Windsurf's Cascade |
|
||||
| `devin` | Opens the page in Devin |
|
||||
|
||||
### MCP
|
||||
|
||||
| Option | Description |
|
||||
|--------|-------------|
|
||||
| `mcp` | Shows instructions for using your docs as an MCP server |
|
||||
| `add-mcp` | Provides a one-click prompt to add your docs MCP server to an AI tool |
|
||||
|
||||
<Tip>
|
||||
The `mcp` and `add-mcp` options are especially powerful — they let developers connect your entire docs site to any MCP-compatible AI assistant, so it can answer questions about your product directly.
|
||||
</Tip>
|
||||
|
||||
## Custom options
|
||||
|
||||
You can add custom entries to the toolbar with a title, description, icon, and link. The `href` supports dynamic placeholders:
|
||||
|
||||
| Placeholder | Resolves to |
|
||||
|-------------|-------------|
|
||||
| `$page` | The current page's full URL |
|
||||
| `$path` | The current page's path |
|
||||
| `$mcp` | Your docs MCP server URL |
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"contextual": {
|
||||
"options": [
|
||||
"copy",
|
||||
"claude",
|
||||
{
|
||||
"title": "Open issue",
|
||||
"description": "Report a problem with this page",
|
||||
"icon": "github",
|
||||
"href": "https://github.com/your-org/docs/issues/new?title=Issue+on+$path"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<Note>
|
||||
The contextual toolbar is only visible on preview and production deployments, not in `mint dev` local preview.
|
||||
</Note>
|
||||
|
||||
## Pairing with Visibility
|
||||
|
||||
The toolbar's `copy` and `view` options expose your page's Markdown content directly. If you use the [`Visibility`](/agent-ready/visibility) component, the `for="agents"` blocks will be included in that Markdown — giving AI assistants structured context that human readers don't see.
|
||||
@@ -0,0 +1,75 @@
|
||||
---
|
||||
title: 'Prompt component'
|
||||
description: 'Embed shareable AI prompts readers can copy or open in Cursor'
|
||||
icon: 'robot'
|
||||
---
|
||||
|
||||
The `Prompt` component displays a pre-built AI prompt with one-click actions to copy it to the clipboard or open it directly in Cursor. It's ideal for any docs page where you want to hand readers a ready-to-use prompt.
|
||||
|
||||
## Basic usage
|
||||
|
||||
<Prompt description="Summarize this API endpoint">
|
||||
You are a technical writer. Given the following API endpoint documentation, write a one-paragraph summary that explains what the endpoint does, what inputs it requires, and what it returns. Be concise and use plain language.
|
||||
</Prompt>
|
||||
|
||||
```mdx
|
||||
<Prompt description="Summarize this API endpoint">
|
||||
You are a technical writer. Given the following API endpoint documentation,
|
||||
write a one-paragraph summary that explains what the endpoint does, what
|
||||
inputs it requires, and what it returns. Be concise and use plain language.
|
||||
</Prompt>
|
||||
```
|
||||
|
||||
## With Cursor integration
|
||||
|
||||
Add `actions={["copy", "cursor"]}` to also surface an "Open in Cursor" button. This is especially useful for prompts readers will use in their editor.
|
||||
|
||||
<Prompt
|
||||
description="Generate a typed API client"
|
||||
icon="code"
|
||||
actions={["copy", "cursor"]}
|
||||
>
|
||||
You are an expert TypeScript developer. Given the following OpenAPI specification, generate a fully-typed API client using native fetch. Include:
|
||||
- A base client class with configurable baseUrl and auth headers
|
||||
- One method per endpoint, with typed request parameters and response types
|
||||
- JSDoc comments on each method
|
||||
Do not use any third-party HTTP libraries.
|
||||
</Prompt>
|
||||
|
||||
```mdx
|
||||
<Prompt
|
||||
description="Generate a typed API client"
|
||||
icon="code"
|
||||
actions={["copy", "cursor"]}
|
||||
>
|
||||
You are an expert TypeScript developer. Given the following OpenAPI
|
||||
specification, generate a fully-typed API client using native fetch...
|
||||
</Prompt>
|
||||
```
|
||||
|
||||
## Props
|
||||
|
||||
<ResponseField name="description" type="string" required>
|
||||
Heading text shown above the prompt content. Supports Markdown.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="children" type="string" required>
|
||||
The prompt text that gets copied or sent to Cursor.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="actions" type="array">
|
||||
Which action buttons to show. Options: `"copy"`, `"cursor"`. Defaults to `["copy"]`.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="icon" type="string">
|
||||
An icon displayed alongside the description. Supports Font Awesome, Lucide, and Tabler icon names, image URLs, or inline SVG.
|
||||
</ResponseField>
|
||||
|
||||
## When to use it
|
||||
|
||||
The `Prompt` component works well anywhere you're teaching readers to work with AI:
|
||||
|
||||
- **Quickstart guides** — give readers a prompt to generate their first integration
|
||||
- **API reference pages** — include a prompt for generating client code from the spec
|
||||
- **Troubleshooting guides** — embed a debugging prompt readers can run against their own error logs
|
||||
- **Conceptual pages** — add a prompt for exploring the topic further with an AI assistant
|
||||
@@ -0,0 +1,85 @@
|
||||
---
|
||||
title: 'Visibility'
|
||||
description: 'Show different content to humans and AI agents'
|
||||
icon: 'eye'
|
||||
---
|
||||
|
||||
The `Visibility` component lets a single page serve two audiences: humans reading on the web and AI agents processing the Markdown output. Content marked `for="humans"` appears on the rendered page but is excluded from Markdown exports. Content marked `for="agents"` is hidden on the web but included in Markdown.
|
||||
|
||||
This means you can write conversational, UI-centric instructions for humans and structured, machine-readable instructions for AI — without maintaining two separate pages.
|
||||
|
||||
## How it works
|
||||
|
||||
Mintlify serves every page at two URLs:
|
||||
|
||||
- `https://docs.example.com/page` — the rendered site, for humans
|
||||
- `https://docs.example.com/page.md` — the raw Markdown, for AI agents
|
||||
|
||||
`Visibility` controls what appears at each URL.
|
||||
|
||||
## Example
|
||||
|
||||
```mdx
|
||||
<Visibility for="humans">
|
||||
<Steps>
|
||||
<Step title="Open the dashboard">
|
||||
Navigate to [dashboard.example.com](https://dashboard.example.com) and sign in.
|
||||
</Step>
|
||||
<Step title="Create an API key">
|
||||
Go to **Settings → API Keys** and click **New key**.
|
||||
</Step>
|
||||
</Steps>
|
||||
</Visibility>
|
||||
|
||||
<Visibility for="agents">
|
||||
To authenticate, send a POST request to `/v1/auth/token` with the user's
|
||||
email and password in the request body. The response includes a bearer token
|
||||
valid for 24 hours. Pass this token as `Authorization: Bearer <token>` on
|
||||
all subsequent requests.
|
||||
</Visibility>
|
||||
```
|
||||
|
||||
Human readers see the step-by-step UI walkthrough. AI agents processing the Markdown get the direct API instructions instead.
|
||||
|
||||
## Props
|
||||
|
||||
<ResponseField name="for" type='"humans" | "agents"' required>
|
||||
- `"humans"` — visible on the rendered web page, excluded from `.md` export
|
||||
- `"agents"` — hidden on the rendered web page, included in `.md` export
|
||||
</ResponseField>
|
||||
|
||||
## When to use it
|
||||
|
||||
<Columns cols={2}>
|
||||
<Card title="Onboarding flows" icon="person-walking-arrow-right">
|
||||
Show UI screenshots and button clicks to humans. Give agents the equivalent API calls.
|
||||
</Card>
|
||||
<Card title="Configuration guides" icon="sliders">
|
||||
Show a visual settings panel to humans. Give agents the equivalent JSON or CLI flags.
|
||||
</Card>
|
||||
<Card title="Error messages" icon="triangle-exclamation">
|
||||
Show a friendly explanation to humans. Give agents structured error codes and remediation steps.
|
||||
</Card>
|
||||
<Card title="Conceptual pages" icon="lightbulb">
|
||||
Include rich diagrams and narrative for humans. Provide a concise structured summary for agents.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## Combining with Prompt
|
||||
|
||||
`Visibility` and `Prompt` complement each other well. Use `Visibility` to give agents structured context, then use `Prompt` to give human readers a prompt they can use to ask an AI about that same content.
|
||||
|
||||
```mdx
|
||||
<Visibility for="agents">
|
||||
## Authentication schema
|
||||
- Method: Bearer token
|
||||
- Header: `Authorization: Bearer <token>`
|
||||
- Token TTL: 86400 seconds
|
||||
- Refresh endpoint: POST /v1/auth/refresh
|
||||
</Visibility>
|
||||
|
||||
<Prompt description="Ask about authentication" icon="lock">
|
||||
Explain how authentication works in this API and show me example code for
|
||||
getting a token and making an authenticated request.
|
||||
</Prompt>
|
||||
```
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: "Claude Code setup"
|
||||
description: "Configure Claude Code for your documentation workflow"
|
||||
icon: "asterisk"
|
||||
---
|
||||
|
||||
Set up Claude Code to help you write and maintain your Mintlify documentation.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Active Claude subscription (Pro, Max, or API access)
|
||||
|
||||
## Setup
|
||||
|
||||
<Steps>
|
||||
<Step title="Install Claude Code">
|
||||
```bash
|
||||
npm install -g @anthropic-ai/claude-code
|
||||
```
|
||||
</Step>
|
||||
|
||||
<Step title="Install the Mintlify skill">
|
||||
In your docs directory, run:
|
||||
|
||||
```bash
|
||||
npx skills add https://mintlify.com/docs
|
||||
```
|
||||
|
||||
This gives Claude Code Mintlify's component reference, writing standards,
|
||||
and workflow guidance.
|
||||
</Step>
|
||||
|
||||
<Step title="Customize project instructions">
|
||||
Edit `AGENTS.md` in your project root to add project-specific terminology,
|
||||
style preferences, and content boundaries.
|
||||
</Step>
|
||||
|
||||
<Step title="Start writing with Claude Code">
|
||||
```bash
|
||||
claude
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: "Cursor setup"
|
||||
description: "Configure Cursor for your documentation workflow"
|
||||
icon: "arrow-pointer"
|
||||
---
|
||||
|
||||
Set up Cursor to help you write and maintain your Mintlify documentation.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Cursor editor installed
|
||||
|
||||
## Setup
|
||||
|
||||
<Steps>
|
||||
<Step title="Open your docs directory in Cursor">
|
||||
Open the root of your documentation repository where `docs.json` is located.
|
||||
</Step>
|
||||
|
||||
<Step title="Install the Mintlify skill">
|
||||
In the integrated terminal, run:
|
||||
|
||||
```bash
|
||||
npx skills add https://mintlify.com/docs
|
||||
```
|
||||
|
||||
This gives Cursor Mintlify's component reference, writing standards,
|
||||
and workflow guidance.
|
||||
</Step>
|
||||
|
||||
<Step title="Customize project instructions">
|
||||
Edit `AGENTS.md` in your project root to add project-specific terminology,
|
||||
style preferences, and content boundaries.
|
||||
</Step>
|
||||
|
||||
<Step title="Start writing with Cursor">
|
||||
Open a file and use Cursor's AI features to draft and edit documentation.
|
||||
</Step>
|
||||
</Steps>
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: "Windsurf setup"
|
||||
description: "Configure Windsurf for your documentation workflow"
|
||||
icon: "water"
|
||||
---
|
||||
|
||||
Set up Windsurf's Cascade AI assistant to help you write and maintain your Mintlify documentation.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Windsurf editor installed
|
||||
|
||||
## Setup
|
||||
|
||||
<Steps>
|
||||
<Step title="Open your docs directory in Windsurf">
|
||||
Open the root of your documentation repository where `docs.json` is located.
|
||||
</Step>
|
||||
|
||||
<Step title="Install the Mintlify skill">
|
||||
In the integrated terminal, run:
|
||||
|
||||
```bash
|
||||
npx skills add https://mintlify.com/docs
|
||||
```
|
||||
|
||||
This gives Windsurf Mintlify's component reference, writing standards,
|
||||
and workflow guidance.
|
||||
</Step>
|
||||
|
||||
<Step title="Customize project instructions">
|
||||
Edit `AGENTS.md` in your project root to add project-specific terminology,
|
||||
style preferences, and content boundaries.
|
||||
</Step>
|
||||
|
||||
<Step title="Start writing with Cascade">
|
||||
Open a file and use Cascade to draft and edit documentation.
|
||||
</Step>
|
||||
</Steps>
|
||||
@@ -0,0 +1,4 @@
|
||||
---
|
||||
title: 'Create Plant'
|
||||
openapi: 'POST /plants'
|
||||
---
|
||||
@@ -0,0 +1,4 @@
|
||||
---
|
||||
title: 'Delete Plant'
|
||||
openapi: 'DELETE /plants/{id}'
|
||||
---
|
||||
@@ -0,0 +1,4 @@
|
||||
---
|
||||
title: 'Get Plants'
|
||||
openapi: 'GET /plants'
|
||||
---
|
||||
@@ -0,0 +1,4 @@
|
||||
---
|
||||
title: 'New Plant'
|
||||
openapi: 'WEBHOOK /plant/webhook'
|
||||
---
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
title: 'Introduction'
|
||||
description: 'Example section for showcasing API endpoints'
|
||||
---
|
||||
|
||||
<Note>
|
||||
If you're not looking to build API reference documentation, you can delete
|
||||
this section by removing the api-reference folder.
|
||||
</Note>
|
||||
|
||||
## Welcome
|
||||
|
||||
There are two ways to build API documentation: [OpenAPI](https://mintlify.com/docs/api-playground/openapi/setup) and [MDX components](https://mintlify.com/docs/api-playground/mdx/configuration). For the starter kit, we are using the following OpenAPI specification.
|
||||
|
||||
<Card
|
||||
title="Plant Store Endpoints"
|
||||
icon="leaf"
|
||||
href="https://github.com/mintlify/starter/blob/main/api-reference/openapi.json"
|
||||
>
|
||||
View the OpenAPI specification file
|
||||
</Card>
|
||||
|
||||
## Authentication
|
||||
|
||||
All API endpoints are authenticated using Bearer tokens and picked up from the specification file.
|
||||
|
||||
```json
|
||||
"security": [
|
||||
{
|
||||
"bearerAuth": []
|
||||
}
|
||||
]
|
||||
```
|
||||
@@ -0,0 +1,217 @@
|
||||
{
|
||||
"openapi": "3.1.0",
|
||||
"info": {
|
||||
"title": "OpenAPI Plant Store",
|
||||
"description": "A sample API that uses a plant store as an example to demonstrate features in the OpenAPI specification",
|
||||
"license": {
|
||||
"name": "MIT"
|
||||
},
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
"url": "http://sandbox.mintlify.com"
|
||||
}
|
||||
],
|
||||
"security": [
|
||||
{
|
||||
"bearerAuth": []
|
||||
}
|
||||
],
|
||||
"paths": {
|
||||
"/plants": {
|
||||
"get": {
|
||||
"description": "Returns all plants from the system that the user has access to",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "limit",
|
||||
"in": "query",
|
||||
"description": "The maximum number of results to return",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"format": "int32"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Plant response",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/Plant"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "Unexpected error",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Error"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"post": {
|
||||
"description": "Creates a new plant in the store",
|
||||
"requestBody": {
|
||||
"description": "Plant to add to the store",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/NewPlant"
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": true
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "plant response",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Plant"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"400": {
|
||||
"description": "unexpected error",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Error"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/plants/{id}": {
|
||||
"delete": {
|
||||
"description": "Deletes a single plant based on the ID supplied",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"description": "ID of plant to delete",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"format": "int64"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"204": {
|
||||
"description": "Plant deleted",
|
||||
"content": {}
|
||||
},
|
||||
"400": {
|
||||
"description": "unexpected error",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Error"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"webhooks": {
|
||||
"/plant/webhook": {
|
||||
"post": {
|
||||
"description": "Information about a new plant added to the store",
|
||||
"requestBody": {
|
||||
"description": "Plant added to the store",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/NewPlant"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Return a 200 status to indicate that the data was received successfully"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"Plant": {
|
||||
"required": [
|
||||
"name"
|
||||
],
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"name": {
|
||||
"description": "The name of the plant",
|
||||
"type": "string"
|
||||
},
|
||||
"tag": {
|
||||
"description": "Tag to specify the type",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"NewPlant": {
|
||||
"allOf": [
|
||||
{
|
||||
"$ref": "#/components/schemas/Plant"
|
||||
},
|
||||
{
|
||||
"required": [
|
||||
"id"
|
||||
],
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"description": "Identification number of the plant",
|
||||
"type": "integer",
|
||||
"format": "int64"
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
"Error": {
|
||||
"required": [
|
||||
"error",
|
||||
"message"
|
||||
],
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"error": {
|
||||
"type": "integer",
|
||||
"format": "int32"
|
||||
},
|
||||
"message": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"securitySchemes": {
|
||||
"bearerAuth": {
|
||||
"type": "http",
|
||||
"scheme": "bearer"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,95 @@
|
||||
---
|
||||
title: 'Development'
|
||||
description: 'Preview changes locally to update your docs'
|
||||
icon: 'terminal'
|
||||
---
|
||||
|
||||
<Info>
|
||||
**Prerequisites**:
|
||||
- Node.js version 19 or higher
|
||||
- A docs repository with a `docs.json` file
|
||||
</Info>
|
||||
|
||||
Follow these steps to install and run Mintlify on your operating system.
|
||||
|
||||
<Steps>
|
||||
<Step title="Install the Mintlify CLI">
|
||||
|
||||
```bash
|
||||
npm i -g mint
|
||||
```
|
||||
</Step>
|
||||
|
||||
<Step title="Preview locally">
|
||||
|
||||
Navigate to your docs directory where your `docs.json` file is located, and run the following command:
|
||||
|
||||
```bash
|
||||
mint dev
|
||||
```
|
||||
|
||||
A local preview of your documentation will be available at `http://localhost:3000`.
|
||||
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Custom ports
|
||||
|
||||
By default, Mintlify uses port 3000. You can customize the port Mintlify runs on by using the `--port` flag. For example, to run Mintlify on port 3333, use this command:
|
||||
|
||||
```bash
|
||||
mint dev --port 3333
|
||||
```
|
||||
|
||||
If you attempt to run Mintlify on a port that's already in use, it will use the next available port:
|
||||
|
||||
```md
|
||||
Port 3000 is already in use. Trying 3001 instead.
|
||||
```
|
||||
|
||||
## Mintlify versions
|
||||
|
||||
Please note that each CLI release is associated with a specific version of Mintlify. If your local preview does not align with the production version, please update the CLI:
|
||||
|
||||
```bash
|
||||
npm mint update
|
||||
```
|
||||
|
||||
## Validating links
|
||||
|
||||
The CLI can assist with validating links in your documentation. To identify any broken links, use the following command:
|
||||
|
||||
```bash
|
||||
mint broken-links
|
||||
```
|
||||
|
||||
## Deployment
|
||||
|
||||
If the deployment is successful, you should see the following:
|
||||
|
||||
<Frame>
|
||||
<img src="/images/checks-passed.png" alt="Screenshot of a deployment confirmation message that says All checks have passed." style={{ borderRadius: '0.5rem' }} />
|
||||
</Frame>
|
||||
|
||||
## Code formatting
|
||||
|
||||
We suggest using extensions on your IDE to recognize and format MDX. If you're a VSCode user, consider the [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) for syntax highlighting, and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) for code formatting.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title='Error: Could not load the "sharp" module using the darwin-arm64 runtime'>
|
||||
|
||||
This may be due to an outdated version of node. Try the following:
|
||||
1. Remove the currently-installed version of the CLI: `npm remove -g mint`
|
||||
2. Upgrade to Node v19 or higher.
|
||||
3. Reinstall the CLI: `npm i -g mint`
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Issue: Encountering an unknown error">
|
||||
|
||||
Solution: Go to the root of your device and delete the `~/.mintlify` folder. Then run `mint dev` again.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
Curious about what changed in the latest CLI version? Check out the [CLI changelog](https://www.npmjs.com/package/mintlify?activeTab=versions).
|
||||
@@ -0,0 +1,126 @@
|
||||
{
|
||||
"$schema": "https://mintlify.com/docs.json",
|
||||
"theme": "mint",
|
||||
"name": "Mintlify Starter Kit",
|
||||
"colors": {
|
||||
"primary": "#16A34A",
|
||||
"light": "#07C983",
|
||||
"dark": "#15803D"
|
||||
},
|
||||
"favicon": "/favicon.svg",
|
||||
"navigation": {
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "Guides",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Getting started",
|
||||
"pages": [
|
||||
"index",
|
||||
"quickstart",
|
||||
"development"
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Customization",
|
||||
"pages": [
|
||||
"essentials/settings",
|
||||
"essentials/navigation"
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Writing content",
|
||||
"pages": [
|
||||
"essentials/markdown",
|
||||
"essentials/code",
|
||||
"essentials/images",
|
||||
"essentials/components",
|
||||
"essentials/reusable-snippets"
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Agent ready",
|
||||
"pages": [
|
||||
"agent-ready/prompt",
|
||||
"agent-ready/visibility",
|
||||
"agent-ready/contextual",
|
||||
"ai-tools/cursor",
|
||||
"ai-tools/claude-code",
|
||||
"ai-tools/windsurf"
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"tab": "API reference",
|
||||
"groups": [
|
||||
{
|
||||
"group": "API documentation",
|
||||
"pages": [
|
||||
"api-reference/introduction"
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "Endpoint examples",
|
||||
"pages": [
|
||||
"api-reference/endpoint/get",
|
||||
"api-reference/endpoint/create",
|
||||
"api-reference/endpoint/delete",
|
||||
"api-reference/endpoint/webhook"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"global": {
|
||||
"anchors": [
|
||||
{
|
||||
"anchor": "Documentation",
|
||||
"href": "https://mintlify.com/docs",
|
||||
"icon": "book-open-cover"
|
||||
},
|
||||
{
|
||||
"anchor": "Blog",
|
||||
"href": "https://mintlify.com/blog",
|
||||
"icon": "newspaper"
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"logo": {
|
||||
"light": "/logo/light.svg",
|
||||
"dark": "/logo/dark.svg"
|
||||
},
|
||||
"navbar": {
|
||||
"links": [
|
||||
{
|
||||
"label": "Support",
|
||||
"href": "mailto:hi@mintlify.com"
|
||||
}
|
||||
],
|
||||
"primary": {
|
||||
"type": "button",
|
||||
"label": "Dashboard",
|
||||
"href": "https://dashboard.mintlify.com"
|
||||
}
|
||||
},
|
||||
"contextual": {
|
||||
"options": [
|
||||
"copy",
|
||||
"view",
|
||||
"chatgpt",
|
||||
"claude",
|
||||
"perplexity",
|
||||
"mcp",
|
||||
"cursor",
|
||||
"vscode"
|
||||
]
|
||||
},
|
||||
"footer": {
|
||||
"socials": {
|
||||
"x": "https://x.com/mintlify",
|
||||
"github": "https://github.com/mintlify",
|
||||
"linkedin": "https://linkedin.com/company/mintlify"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: 'Code blocks'
|
||||
description: 'Display inline code and code blocks'
|
||||
icon: 'code'
|
||||
---
|
||||
|
||||
## Inline code
|
||||
|
||||
To denote a `word` or `phrase` as code, enclose it in backticks (`).
|
||||
|
||||
```
|
||||
To denote a `word` or `phrase` as code, enclose it in backticks (`).
|
||||
```
|
||||
|
||||
## Code blocks
|
||||
|
||||
Use [fenced code blocks](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) by enclosing code in three backticks and follow the leading ticks with the programming language of your snippet to get syntax highlighting. Optionally, you can also write the name of your code after the programming language.
|
||||
|
||||
```java HelloWorld.java
|
||||
class HelloWorld {
|
||||
public static void main(String[] args) {
|
||||
System.out.println("Hello, World!");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
````md
|
||||
```java HelloWorld.java
|
||||
class HelloWorld {
|
||||
public static void main(String[] args) {
|
||||
System.out.println("Hello, World!");
|
||||
}
|
||||
}
|
||||
```
|
||||
````
|
||||
|
||||
## Code groups
|
||||
|
||||
To display the same snippet in multiple languages as tabs, use the `CodeGroup` component. See [Components](/essentials/components#code-groups) for usage.
|
||||
@@ -0,0 +1,207 @@
|
||||
---
|
||||
title: 'Components'
|
||||
description: 'Callouts, cards, steps, tabs, and more'
|
||||
icon: 'puzzle-piece'
|
||||
---
|
||||
|
||||
Mintlify components let you build rich, interactive documentation pages using MDX. Here are some commonly used ones.
|
||||
|
||||
See the [components overview](https://mintlify.com/docs/components) in the Mintlify documentation for a complete list.
|
||||
|
||||
## Callouts
|
||||
|
||||
Use callouts to draw attention to important information.
|
||||
|
||||
<Note>A **Note** is for general information that helps the reader.</Note>
|
||||
|
||||
<Tip>A **Tip** highlights a helpful shortcut or best practice.</Tip>
|
||||
|
||||
<Warning>A **Warning** flags something that could cause problems.</Warning>
|
||||
|
||||
<Info>An **Info** callout provides supplementary context.</Info>
|
||||
|
||||
```mdx
|
||||
<Note>A **Note** is for general information that helps the reader.</Note>
|
||||
|
||||
<Tip>A **Tip** highlights a helpful shortcut or best practice.</Tip>
|
||||
|
||||
<Warning>A **Warning** flags something that could cause problems.</Warning>
|
||||
|
||||
<Info>An **Info** callout provides supplementary context.</Info>
|
||||
```
|
||||
|
||||
## Cards
|
||||
|
||||
Cards link readers to other pages or resources.
|
||||
|
||||
<Columns cols={2}>
|
||||
<Card title="API Reference" icon="terminal" href="/api-reference/introduction">
|
||||
Auto-generated docs from your OpenAPI spec.
|
||||
</Card>
|
||||
<Card title="Quickstart" icon="rocket" href="/quickstart">
|
||||
Get your docs running in three steps.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
```mdx
|
||||
<Columns cols={2}>
|
||||
<Card title="API Reference" icon="terminal" href="/api-reference/introduction">
|
||||
Auto-generated docs from your OpenAPI spec.
|
||||
</Card>
|
||||
<Card title="Quickstart" icon="rocket" href="/quickstart">
|
||||
Get your docs running in three steps.
|
||||
</Card>
|
||||
</Columns>
|
||||
```
|
||||
|
||||
Use `<Columns cols={N}>` to control the grid width. Cards without `href` render as informational panels.
|
||||
|
||||
## Steps
|
||||
|
||||
Steps present numbered procedures clearly.
|
||||
|
||||
<Steps>
|
||||
<Step title="Install the package">
|
||||
```bash
|
||||
npm install my-package
|
||||
```
|
||||
</Step>
|
||||
<Step title="Initialize">
|
||||
Run the init command in your project root.
|
||||
```bash
|
||||
npx my-package init
|
||||
```
|
||||
</Step>
|
||||
<Step title="You're ready">
|
||||
Start using the package in your code.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
````mdx
|
||||
<Steps>
|
||||
<Step title="Install the package">
|
||||
```bash
|
||||
npm install my-package
|
||||
```
|
||||
</Step>
|
||||
<Step title="Initialize">
|
||||
Run the init command in your project root.
|
||||
</Step>
|
||||
<Step title="You're ready">
|
||||
Start using the package in your code.
|
||||
</Step>
|
||||
</Steps>
|
||||
````
|
||||
|
||||
## Tabs
|
||||
|
||||
Tabs let readers switch between alternative content — different languages, environments, or platforms.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="npm">
|
||||
```bash
|
||||
npm install my-package
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="yarn">
|
||||
```bash
|
||||
yarn add my-package
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="pnpm">
|
||||
```bash
|
||||
pnpm add my-package
|
||||
```
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
````mdx
|
||||
<Tabs>
|
||||
<Tab title="npm">
|
||||
```bash
|
||||
npm install my-package
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="yarn">
|
||||
```bash
|
||||
yarn add my-package
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="pnpm">
|
||||
```bash
|
||||
pnpm add my-package
|
||||
```
|
||||
</Tab>
|
||||
</Tabs>
|
||||
````
|
||||
|
||||
## Accordions
|
||||
|
||||
Accordions collapse content behind a toggle — useful for FAQs or optional detail.
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="What does this product do?">
|
||||
A brief answer to the first question. Keep it concise.
|
||||
</Accordion>
|
||||
<Accordion title="How is pricing calculated?">
|
||||
Another answer here. Use as much space as you need.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
```mdx
|
||||
<AccordionGroup>
|
||||
<Accordion title="What does this product do?">
|
||||
A brief answer to the first question.
|
||||
</Accordion>
|
||||
<Accordion title="How is pricing calculated?">
|
||||
Another answer here.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
```
|
||||
|
||||
## Frames
|
||||
|
||||
Wrap images or other content in a `Frame` to add a styled border and rounded corners.
|
||||
|
||||
<Frame>
|
||||
<img src="https://mintlify-assets.b-cdn.net/bigbend.jpg" alt="Big Bend landscape" />
|
||||
</Frame>
|
||||
|
||||
```mdx
|
||||
<Frame>
|
||||
<img src="/images/screenshot.png" alt="App screenshot" />
|
||||
</Frame>
|
||||
```
|
||||
|
||||
## Code groups
|
||||
|
||||
`CodeGroup` displays multiple code snippets as tabs — ideal for showing the same example in multiple languages.
|
||||
|
||||
<CodeGroup>
|
||||
```typescript TypeScript
|
||||
const response = await fetch('https://api.example.com/users');
|
||||
const users = await response.json();
|
||||
```
|
||||
|
||||
```python Python
|
||||
import requests
|
||||
response = requests.get('https://api.example.com/users')
|
||||
users = response.json()
|
||||
```
|
||||
|
||||
```bash curl
|
||||
curl https://api.example.com/users
|
||||
```
|
||||
</CodeGroup>
|
||||
|
||||
````mdx
|
||||
<CodeGroup>
|
||||
```typescript TypeScript
|
||||
const response = await fetch('https://api.example.com/users');
|
||||
```
|
||||
|
||||
```python Python
|
||||
response = requests.get('https://api.example.com/users')
|
||||
```
|
||||
</CodeGroup>
|
||||
````
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
title: 'Images and embeds'
|
||||
description: 'Add image, video, and other HTML elements'
|
||||
icon: 'image'
|
||||
---
|
||||
|
||||
<img
|
||||
style={{ borderRadius: '0.5rem' }}
|
||||
src="https://mintlify-assets.b-cdn.net/bigbend.jpg"
|
||||
/>
|
||||
|
||||
## Image
|
||||
|
||||
### Using Markdown
|
||||
|
||||
The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets you add images using the following code
|
||||
|
||||
```md
|
||||
|
||||
```
|
||||
|
||||
Note that the image file size must be less than 5MB. Otherwise, we recommend hosting on a service like [Cloudinary](https://cloudinary.com/) or [S3](https://aws.amazon.com/s3/). You can then use that URL and embed.
|
||||
|
||||
### Using embeds
|
||||
|
||||
To get more customizability with images, you can also use [embeds](/writing-content/embed) to add images
|
||||
|
||||
```html
|
||||
<img height="200" src="/path/image.jpg" />
|
||||
```
|
||||
|
||||
## Embeds and HTML elements
|
||||
|
||||
<iframe
|
||||
width="560"
|
||||
height="315"
|
||||
src="https://www.youtube.com/embed/4KzFe50RQkQ"
|
||||
title="YouTube video player"
|
||||
frameBorder="0"
|
||||
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
|
||||
allowFullScreen
|
||||
style={{ width: '100%', borderRadius: '0.5rem' }}
|
||||
></iframe>
|
||||
|
||||
<br />
|
||||
|
||||
<Tip>
|
||||
|
||||
Mintlify supports [HTML tags in Markdown](https://www.markdownguide.org/basic-syntax/#html). This is helpful if you prefer HTML tags to Markdown syntax, and lets you create documentation with infinite flexibility.
|
||||
|
||||
</Tip>
|
||||
|
||||
### iFrames
|
||||
|
||||
Loads another HTML page within the document. Most commonly used for embedding videos.
|
||||
|
||||
```html
|
||||
<iframe src="https://www.youtube.com/embed/4KzFe50RQkQ"> </iframe>
|
||||
```
|
||||
@@ -0,0 +1,88 @@
|
||||
---
|
||||
title: 'Markdown syntax'
|
||||
description: 'Text, title, and styling in standard markdown'
|
||||
icon: 'text-size'
|
||||
---
|
||||
|
||||
## Titles
|
||||
|
||||
Best used for section headers.
|
||||
|
||||
```md
|
||||
## Titles
|
||||
```
|
||||
|
||||
### Subtitles
|
||||
|
||||
Best used for subsection headers.
|
||||
|
||||
```md
|
||||
### Subtitles
|
||||
```
|
||||
|
||||
<Tip>
|
||||
|
||||
Each **title** and **subtitle** creates an anchor and also shows up on the table of contents on the right.
|
||||
|
||||
</Tip>
|
||||
|
||||
## Text formatting
|
||||
|
||||
We support most markdown formatting. Simply add `**`, `_`, or `~` around text to format it.
|
||||
|
||||
| Style | How to write it | Result |
|
||||
| ------------- | ----------------- | --------------- |
|
||||
| Bold | `**bold**` | **bold** |
|
||||
| Italic | `_italic_` | _italic_ |
|
||||
| Strikethrough | `~strikethrough~` | ~strikethrough~ |
|
||||
|
||||
You can combine these. For example, write `**_bold and italic_**` to get **_bold and italic_** text.
|
||||
|
||||
You need to use HTML to write superscript and subscript text. That is, add `<sup>` or `<sub>` around your text.
|
||||
|
||||
| Text Size | How to write it | Result |
|
||||
| ----------- | ------------------------ | ---------------------- |
|
||||
| Superscript | `<sup>superscript</sup>` | <sup>superscript</sup> |
|
||||
| Subscript | `<sub>subscript</sub>` | <sub>subscript</sub> |
|
||||
|
||||
## Linking to pages
|
||||
|
||||
You can add a link by wrapping text in `[]()`. You would write `[link to google](https://google.com)` to [link to google](https://google.com).
|
||||
|
||||
Links to pages in your docs need to be root-relative. Basically, you should include the entire folder path. For example, `[link to text](/writing-content/text)` links to the page "Text" in our components section.
|
||||
|
||||
Relative links like `[link to text](../text)` will open slower because we cannot optimize them as easily.
|
||||
|
||||
## Blockquotes
|
||||
|
||||
### Singleline
|
||||
|
||||
To create a blockquote, add a `>` in front of a paragraph.
|
||||
|
||||
> Dorothy followed her through many of the beautiful rooms in her castle.
|
||||
|
||||
```md
|
||||
> Dorothy followed her through many of the beautiful rooms in her castle.
|
||||
```
|
||||
|
||||
### Multiline
|
||||
|
||||
> Dorothy followed her through many of the beautiful rooms in her castle.
|
||||
>
|
||||
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
|
||||
|
||||
```md
|
||||
> Dorothy followed her through many of the beautiful rooms in her castle.
|
||||
>
|
||||
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
|
||||
```
|
||||
|
||||
### LaTeX
|
||||
|
||||
Mintlify supports [LaTeX](https://www.latex-project.org) through the Latex component.
|
||||
|
||||
<Latex>8 x (vk x H1 - H2) = (0,1)</Latex>
|
||||
|
||||
```md
|
||||
<Latex>8 x (vk x H1 - H2) = (0,1)</Latex>
|
||||
```
|
||||
@@ -0,0 +1,87 @@
|
||||
---
|
||||
title: 'Navigation'
|
||||
description: 'The navigation field in docs.json defines the pages that go in the navigation menu'
|
||||
icon: 'map'
|
||||
---
|
||||
|
||||
The navigation menu is the list of links on every website.
|
||||
|
||||
You will likely update `docs.json` every time you add a new page. Pages do not show up automatically.
|
||||
|
||||
## Navigation syntax
|
||||
|
||||
Our navigation syntax is recursive which means you can make nested navigation groups. You don't need to include `.mdx` in page names.
|
||||
|
||||
<CodeGroup>
|
||||
|
||||
```json Regular Navigation
|
||||
"navigation": {
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "Docs",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Getting Started",
|
||||
"pages": ["quickstart"]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
```json Nested Navigation
|
||||
"navigation": {
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "Docs",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Getting Started",
|
||||
"pages": [
|
||||
"quickstart",
|
||||
{
|
||||
"group": "Nested Reference Pages",
|
||||
"pages": ["nested-reference-page"]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
</CodeGroup>
|
||||
|
||||
## Folders
|
||||
|
||||
Simply put your MDX files in folders and update the paths in `docs.json`.
|
||||
|
||||
For example, to have a page at `https://yoursite.com/your-folder/your-page` you would make a folder called `your-folder` containing an MDX file called `your-page.mdx`.
|
||||
|
||||
<Warning>
|
||||
|
||||
You cannot use `api` for the name of a folder unless you nest it inside another folder. Mintlify uses Next.js which reserves the top-level `api` folder for internal server calls. A folder name such as `api-reference` would be accepted.
|
||||
|
||||
</Warning>
|
||||
|
||||
```json Navigation With Folder
|
||||
"navigation": {
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "Docs",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Group Name",
|
||||
"pages": ["your-folder/your-page"]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## Hidden pages
|
||||
|
||||
MDX files not included in `docs.json` will not show up in the sidebar but are accessible through the search bar and by linking directly to them.
|
||||
@@ -0,0 +1,100 @@
|
||||
---
|
||||
title: "Reusable snippets"
|
||||
description: "Write once, reuse everywhere. Use snippets to keep content in sync across pages"
|
||||
icon: "recycle"
|
||||
---
|
||||
|
||||
Any content you find yourself repeating across pages is a good candidate for a snippet. Create the file once in the `snippets/` directory, import it wherever you need it, and updates propagate everywhere automatically.
|
||||
|
||||
<Note>
|
||||
Files inside `snippets/` are not rendered as standalone pages. They only appear where you import them.
|
||||
</Note>
|
||||
|
||||
## Content snippets
|
||||
|
||||
The simplest pattern: write MDX content in a snippet file and import it as a component.
|
||||
|
||||
```mdx snippets/prerequisites.mdx
|
||||
Before you begin, make sure you have:
|
||||
- Node.js 18 or higher
|
||||
- An API key from your [dashboard](https://dashboard.example.com)
|
||||
```
|
||||
|
||||
Import it into any page using a root-relative path:
|
||||
|
||||
```mdx your-page.mdx
|
||||
---
|
||||
title: Install the SDK
|
||||
---
|
||||
|
||||
import Prerequisites from '/snippets/prerequisites.mdx';
|
||||
|
||||
<Prerequisites />
|
||||
|
||||
## Installation
|
||||
...
|
||||
```
|
||||
|
||||
You can also use relative imports, which enables CMD+click navigation to the snippet in your editor:
|
||||
|
||||
```mdx
|
||||
import Prerequisites from '../snippets/prerequisites.mdx';
|
||||
```
|
||||
|
||||
## Variable snippets
|
||||
|
||||
Export named constants from a snippet file to reuse values like product names, version numbers, or URLs.
|
||||
|
||||
```mdx snippets/vars.mdx
|
||||
export const sdkVersion = '3.2.0';
|
||||
export const baseUrl = 'https://api.example.com/v1';
|
||||
```
|
||||
|
||||
Import and use them inline:
|
||||
|
||||
```mdx your-page.mdx
|
||||
import { sdkVersion, baseUrl } from '/snippets/vars.mdx';
|
||||
|
||||
The current SDK version is **{sdkVersion}**.
|
||||
|
||||
All requests go to `{baseUrl}`.
|
||||
```
|
||||
|
||||
## Component snippets
|
||||
|
||||
For snippets that need to vary based on where they're used, export an arrow function component that accepts props.
|
||||
|
||||
```mdx snippets/endpoint-note.mdx
|
||||
export const EndpointNote = ({ method, path }) => (
|
||||
<Note>
|
||||
This guide covers the <code>{method} {path}</code> endpoint.
|
||||
See the <a href="/api-reference/introduction">API reference</a> for full details.
|
||||
</Note>
|
||||
);
|
||||
```
|
||||
|
||||
* Use arrow function syntax (`const Foo = () => ...`).
|
||||
* The `function` keyword is not supported in snippet files.
|
||||
* MDX syntax doesn't compile inside arrow function bodies. Use plain HTML tags there, or use a default export instead.
|
||||
|
||||
Pass props when you render it:
|
||||
|
||||
```mdx your-page.mdx
|
||||
import { EndpointNote } from '/snippets/endpoint-note.mdx';
|
||||
|
||||
<EndpointNote method="POST" path="/v1/users" />
|
||||
```
|
||||
|
||||
## Snippets importing snippets
|
||||
|
||||
Snippets can import other snippets, which is useful for composing larger shared sections from smaller pieces.
|
||||
|
||||
```mdx snippets/auth-intro.mdx
|
||||
import AuthNote from '/snippets/auth-note.mdx';
|
||||
|
||||
## Authentication
|
||||
|
||||
All endpoints require a bearer token.
|
||||
|
||||
<AuthNote />
|
||||
```
|
||||
@@ -0,0 +1,174 @@
|
||||
---
|
||||
title: 'Configuration'
|
||||
description: 'Customize your site with the `docs.json` file'
|
||||
icon: 'gear'
|
||||
---
|
||||
|
||||
Every Mintlify site is configured through a `docs.json` file in your project root. Changes take effect immediately in local preview.
|
||||
|
||||
## Identity
|
||||
|
||||
Set the name, theme, and visual identity of your site.
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"name": "Acme Docs",
|
||||
"theme": "mint",
|
||||
"favicon": "/favicon.svg",
|
||||
"logo": {
|
||||
"light": "/logo/light.svg",
|
||||
"dark": "/logo/dark.svg"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<ResponseField name="name" type="string" required>
|
||||
Your project name. Appears in the browser tab title and site metadata.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="theme" type="string">
|
||||
The visual theme. Options: `mint`, `maple`, `willow`, `sequoia`, `prism`.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="favicon" type="string">
|
||||
Path to your favicon. SVG recommended for crisp rendering at all sizes.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="logo" type="object">
|
||||
<Expandable title="Logo">
|
||||
<ResponseField name="light" type="string">Logo shown in light mode.</ResponseField>
|
||||
<ResponseField name="dark" type="string">Logo shown in dark mode.</ResponseField>
|
||||
<ResponseField name="href" type="string" default="/">URL the logo links to.</ResponseField>
|
||||
</Expandable>
|
||||
</ResponseField>
|
||||
|
||||
## Colors
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"colors": {
|
||||
"primary": "#16A34A",
|
||||
"light": "#07C983",
|
||||
"dark": "#15803D"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<ResponseField name="colors.primary" type="string" required>
|
||||
Primary brand color. Used for highlights, active states, and accents in light mode.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="colors.light" type="string">
|
||||
Primary color for dark mode.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="colors.dark" type="string">
|
||||
Used for buttons and important interactive elements.
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="colors.background" type="object">
|
||||
Override the default page background color.
|
||||
<Expandable title="Background">
|
||||
<ResponseField name="light" type="string">Background hex color in light mode.</ResponseField>
|
||||
<ResponseField name="dark" type="string">Background hex color in dark mode.</ResponseField>
|
||||
</Expandable>
|
||||
</ResponseField>
|
||||
|
||||
## Navbar
|
||||
|
||||
Configure the top navigation bar links and primary call-to-action.
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"navbar": {
|
||||
"links": [
|
||||
{ "label": "Support", "href": "mailto:support@example.com" }
|
||||
],
|
||||
"primary": {
|
||||
"type": "button",
|
||||
"label": "Dashboard",
|
||||
"href": "https://dashboard.example.com"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<ResponseField name="navbar.links" type="array">
|
||||
Text links displayed in the top navigation bar.
|
||||
<Expandable title="Link">
|
||||
<ResponseField name="label" type="string">Display text for the link.</ResponseField>
|
||||
<ResponseField name="href" type="string">URL the link points to.</ResponseField>
|
||||
</Expandable>
|
||||
</ResponseField>
|
||||
|
||||
<ResponseField name="navbar.primary" type="object">
|
||||
The prominent call-to-action in the top-right corner.
|
||||
<Expandable title="Primary">
|
||||
<ResponseField name="type" type='"button" | "github"'>
|
||||
`button` renders a CTA button. `github` renders a star count badge.
|
||||
</ResponseField>
|
||||
<ResponseField name="label" type="string">Button label. Required when type is `button`.</ResponseField>
|
||||
<ResponseField name="href" type="string">URL the button or badge links to.</ResponseField>
|
||||
</Expandable>
|
||||
</ResponseField>
|
||||
|
||||
## Navigation
|
||||
|
||||
Organize your pages into tabs and groups. See the [Navigation](/essentials/navigation) guide for full details.
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"navigation": {
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "Guides",
|
||||
"groups": [
|
||||
{
|
||||
"group": "Getting started",
|
||||
"pages": ["index", "quickstart"]
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"global": {
|
||||
"anchors": [
|
||||
{
|
||||
"anchor": "Blog",
|
||||
"href": "https://example.com/blog",
|
||||
"icon": "newspaper"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Contextual toolbar
|
||||
|
||||
The contextual toolbar floats on every page and gives readers one-click access to AI tools and integrations. See [Contextual toolbar](/agent-ready/contextual) for the full list of options.
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"contextual": {
|
||||
"options": ["copy", "view", "claude", "mcp", "cursor", "vscode"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Footer
|
||||
|
||||
```json docs.json
|
||||
{
|
||||
"footer": {
|
||||
"socials": {
|
||||
"x": "https://x.com/yourhandle",
|
||||
"github": "https://github.com/yourorg",
|
||||
"linkedin": "https://linkedin.com/company/yourco"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
<ResponseField name="footer.socials" type="object">
|
||||
Social links shown in the footer. Supported keys: `x`, `github`, `linkedin`, `discord`, `slack`, `facebook`, `instagram`, `website`.
|
||||
</ResponseField>
|
||||
@@ -0,0 +1,5 @@
|
||||
<svg width="502" height="502" viewBox="0 0 502 502" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M501.402 185.33V29.9622C501.402 13.2897 487.876 0 471.453 0H316.156C291.763 0 267.611 4.83243 245.15 14.0144C222.689 23.438 202.16 36.9695 185.012 54.3668L183.804 55.575C161.101 78.5299 144.92 107.042 136.708 138.454C151.441 134.588 166.656 132.655 181.871 132.413C222.447 131.93 262.298 144.978 294.661 169.383C323.885 191.13 346.104 221.092 358.18 255.645C370.739 290.681 372.188 328.859 362.769 364.862C393.925 356.647 422.666 340.457 445.611 317.744L446.818 316.536C463.966 299.38 477.732 278.841 487.151 256.37C496.571 233.898 501.16 209.735 501.16 185.33H501.402Z" fill="#18E299"/>
|
||||
<path d="M132.071 182.706C132.312 135.044 151.32 89.3068 184.764 55.1246L55.5569 184.391C55.0756 184.873 54.5942 185.113 54.113 185.595C22.5932 216.888 3.58552 258.774 0.457596 303.066C-2.42971 344.47 8.39746 385.392 31.4959 419.575C33.6992 422.835 39.6774 423.907 43.0459 420.778L122.206 341.822C146.989 317.028 154.689 280.198 142.899 247.219C135.44 226.758 131.831 204.852 132.071 182.706Z" fill="#0C8C5E"/>
|
||||
<path d="M446.067 316.547C421.284 340.86 390.245 357.71 356.56 365.172C322.634 372.635 287.506 370.468 254.783 358.914C254.783 358.914 254.542 358.914 254.301 358.914C221.338 347.118 184.525 354.821 159.742 379.375L80.5808 458.331C77.2123 461.701 77.6935 467.238 81.7838 469.885C115.95 492.754 156.855 503.827 198.24 500.938C242.512 497.809 284.137 478.792 315.656 447.258L316.859 446.054L446.067 316.788V316.547Z" fill="#0C8C5E"/>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 1.5 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 157 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 108 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 102 KiB |
@@ -0,0 +1,133 @@
|
||||
---
|
||||
title: "Introduction"
|
||||
description: "Welcome to the new home for your documentation"
|
||||
icon: 'star'
|
||||
---
|
||||
|
||||
## Setting up
|
||||
|
||||
Get your documentation site up and running in minutes.
|
||||
|
||||
<Card
|
||||
title="Start here"
|
||||
icon="rocket"
|
||||
href="/quickstart"
|
||||
horizontal
|
||||
>
|
||||
Follow our three step quickstart guide.
|
||||
</Card>
|
||||
|
||||
## Make it yours
|
||||
|
||||
Design a docs site that looks great and empowers your users.
|
||||
|
||||
<Columns cols={2}>
|
||||
<Card
|
||||
title="Edit locally"
|
||||
icon="pen-to-square"
|
||||
href="/development"
|
||||
>
|
||||
Edit your docs locally and preview them in real time.
|
||||
</Card>
|
||||
<Card
|
||||
title="Customize your site"
|
||||
icon="palette"
|
||||
href="/essentials/settings"
|
||||
>
|
||||
Customize the design and colors of your site to match your brand.
|
||||
</Card>
|
||||
<Card
|
||||
title="Set up navigation"
|
||||
icon="map"
|
||||
href="/essentials/navigation"
|
||||
>
|
||||
Organize your docs to help users find what they need and succeed with your product.
|
||||
</Card>
|
||||
<Card
|
||||
title="API documentation"
|
||||
icon="terminal"
|
||||
href="/api-reference/introduction"
|
||||
>
|
||||
Auto-generate API documentation from OpenAPI specifications.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## Create beautiful pages
|
||||
|
||||
Everything you need to create world-class documentation.
|
||||
|
||||
<Columns cols={2}>
|
||||
<Card
|
||||
title="Write with MDX"
|
||||
icon="pen-fancy"
|
||||
href="/essentials/markdown"
|
||||
>
|
||||
Use MDX to style your docs pages.
|
||||
</Card>
|
||||
<Card
|
||||
title="Code samples"
|
||||
icon="code"
|
||||
href="/essentials/code"
|
||||
>
|
||||
Add sample code to demonstrate how to use your product.
|
||||
</Card>
|
||||
<Card
|
||||
title="Images"
|
||||
icon="image"
|
||||
href="/essentials/images"
|
||||
>
|
||||
Display images and other media.
|
||||
</Card>
|
||||
<Card
|
||||
title="Reusable snippets"
|
||||
icon="recycle"
|
||||
href="/essentials/reusable-snippets"
|
||||
>
|
||||
Write once and reuse across your docs.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## Make your content agent ready
|
||||
|
||||
Make your docs work for humans and AI agents alike.
|
||||
|
||||
<Columns cols={2}>
|
||||
<Card
|
||||
title="Prompt component"
|
||||
icon="robot"
|
||||
href="/agent-ready/prompt"
|
||||
>
|
||||
Embed shareable AI prompts readers can copy or open in Cursor.
|
||||
</Card>
|
||||
<Card
|
||||
title="Visibility"
|
||||
icon="eye"
|
||||
href="/agent-ready/visibility"
|
||||
>
|
||||
Show different content to humans and agents reading your docs.
|
||||
</Card>
|
||||
<Card
|
||||
title="Contextual menu"
|
||||
icon="bolt"
|
||||
href="/agent-ready/contextual"
|
||||
>
|
||||
Give readers one-click access to Claude, ChatGPT, Cursor, and more.
|
||||
</Card>
|
||||
<Card
|
||||
title="AI coding tools"
|
||||
icon="wand-magic-sparkles"
|
||||
href="/ai-tools/claude-code"
|
||||
>
|
||||
Set up Claude Code, Cursor, or Windsurf with Mintlify's skill.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## Need inspiration?
|
||||
|
||||
<Card
|
||||
title="See complete examples"
|
||||
icon="stars"
|
||||
href="https://mintlify.com/customers"
|
||||
>
|
||||
Browse our showcase of exceptional documentation sites.
|
||||
</Card>
|
||||
@@ -0,0 +1,17 @@
|
||||
<svg width="180" height="23" viewBox="0 0 180 23" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<!-- mintlify wordmark paths -->
|
||||
<path d="M91.4402 21.4758H88.1331L90.4636 16.2156L85.8025 5.73975H89.1319L91.8475 12.3068C91.9428 12.5363 92.2682 12.5359 92.3624 12.3061L95.0575 5.73975H98.4091L91.4402 21.4758Z" fill="white"/>
|
||||
<path d="M81.3934 16.8371V8.4031H79.1517V5.73971H81.3934V4.29706C81.3934 2.98017 81.7924 1.94441 82.5917 1.18979C83.391 0.435172 84.4044 0.0578613 85.6326 0.0578613C86.3869 0.0578613 87.0305 0.139242 87.5636 0.302003V2.98757C87.2084 2.8544 86.7941 2.78782 86.3202 2.78782C85.6549 2.78782 85.1739 2.93578 84.8778 3.23171C84.5817 3.51284 84.4337 3.99373 84.4337 4.67437V5.73971H87.5636V8.4031H84.4337V16.8371H81.3934Z" fill="white"/>
|
||||
<path d="M76.4325 3.91974C75.9147 3.91974 75.4635 3.73479 75.0785 3.36488C74.6941 2.98017 74.5016 2.52148 74.5016 1.9888C74.5016 1.45613 74.6941 1.00484 75.0785 0.634923C75.4635 0.250216 75.9147 0.0578613 76.4325 0.0578613C76.9802 0.0578613 77.4384 0.250216 77.8087 0.634923C78.1932 1.00484 78.3857 1.45613 78.3857 1.9888C78.3857 2.52148 78.1932 2.98017 77.8087 3.36488C77.4384 3.73479 76.9802 3.91974 76.4325 3.91974ZM74.9235 16.8371V5.73971H77.9638V16.8371H74.9235Z" fill="white"/>
|
||||
<path d="M69.6281 16.837V0.190918H72.669V16.837H69.6281Z" fill="white"/>
|
||||
<path d="M66.1938 16.9702C64.951 16.9702 63.9299 16.6298 63.1306 15.9492C62.3466 15.2537 61.9545 14.255 61.9545 12.9529V8.40297H59.7129V5.73961H61.9545V2.65454H64.9949V5.73961H68.1247V8.40297H64.9949V12.3537C64.9949 13.0343 65.1429 13.5226 65.439 13.8185C65.735 14.0996 66.216 14.2402 66.8819 14.2402C67.3553 14.2402 67.7695 14.1736 68.1247 14.0405V16.726C67.5917 16.8888 66.948 16.9702 66.1938 16.9702Z" fill="white"/>
|
||||
<path d="M48.3319 16.8369V5.73951H51.3726V6.55065C51.3726 6.68781 51.5593 6.74849 51.6501 6.64568C52.3279 5.87881 53.2934 5.49536 54.5464 5.49536C55.8781 5.49536 56.9213 5.93925 57.6759 6.82707C58.4453 7.70003 58.8299 8.86894 58.8299 10.3338V16.8369H55.7893V10.8443C55.7893 10.0305 55.6192 9.40164 55.2789 8.95776C54.9386 8.49908 54.4576 8.26971 53.8362 8.26971C53.0964 8.26971 52.4971 8.53606 52.0384 9.0687C51.5945 9.6014 51.3726 10.3856 51.3726 11.4213V16.8369H48.3319Z" fill="white"/>
|
||||
<path d="M44.5472 3.91974C44.0293 3.91974 43.578 3.73479 43.1933 3.36488C42.8086 2.98017 42.6162 2.52148 42.6162 1.9888C42.6162 1.45613 42.8086 1.00484 43.1933 0.634923C43.578 0.250216 44.0293 0.0578613 44.5472 0.0578613C45.0946 0.0578613 45.5533 0.250216 45.9232 0.634923C46.308 1.00484 46.5003 1.45613 46.5003 1.9888C46.5003 2.52148 46.308 2.98017 45.9232 3.36488C45.5533 3.73479 45.0946 3.91974 44.5472 3.91974ZM43.0379 16.8371V5.73971H46.0786V16.8371H43.0379Z" fill="white"/>
|
||||
<path d="M37.8749 16.8369V10.9109C37.8749 9.15009 37.2978 8.26971 36.1437 8.26971C35.4778 8.26971 34.9452 8.52126 34.5457 9.02435C34.1609 9.52739 33.9538 10.2747 33.9242 11.266V16.8369H30.8836V10.9109C30.8836 9.15009 30.3065 8.26971 29.1524 8.26971C28.4717 8.26971 27.9317 8.53606 27.5321 9.0687C27.1327 9.6014 26.9329 10.3856 26.9329 11.4213V16.8369H23.8922V5.73951H26.9329V6.55861C26.9329 6.69506 27.1163 6.75516 27.206 6.65229C27.8778 5.88103 28.7707 5.49536 29.8848 5.49536C31.3489 5.49536 32.4517 6.09981 33.193 7.30875C33.2515 7.40413 33.3954 7.4026 33.4536 7.30705C33.7741 6.78026 34.2195 6.36131 34.7898 6.05025C35.4409 5.68032 36.0993 5.49536 36.7652 5.49536C38.082 5.49536 39.103 5.93188 39.828 6.80484C40.5531 7.67785 40.9156 8.87637 40.9156 10.4004V16.8369H37.8749Z" fill="white"/>
|
||||
<!-- M icon -->
|
||||
<path d="M19.4027 7.36208V1.35027C19.4027 0.705146 18.8794 0.190918 18.2439 0.190918H12.2349C11.291 0.190918 10.3565 0.377903 9.48742 0.733186C8.61827 1.09782 7.82396 1.62141 7.16042 2.29458L7.11373 2.34133C6.23527 3.22954 5.60912 4.33278 5.29138 5.54823C5.86143 5.39864 6.45019 5.32384 7.03895 5.3145C8.60891 5.29579 10.1509 5.80067 11.4032 6.745C12.534 7.58647 13.3937 8.74579 13.861 10.0828C14.3469 11.4385 14.403 12.9157 14.0386 14.3088C15.2441 13.991 16.3562 13.3645 17.244 12.4856L17.2907 12.4389C17.9543 11.7751 18.4869 10.9803 18.8514 10.1108C19.2159 9.24134 19.3934 8.30636 19.3934 7.36208H19.4027Z" fill="#18E299"/>
|
||||
<path d="M5.11193 7.26034C5.12124 5.4161 5.85673 3.64637 7.1508 2.32373L2.15129 7.32553C2.13267 7.34419 2.11404 7.3535 2.09543 7.3721C0.875804 8.58297 0.140324 10.2037 0.019293 11.9175C-0.0924279 13.5196 0.326517 15.103 1.22029 16.4257C1.30553 16.5519 1.53685 16.5933 1.6672 16.4723L4.73021 13.4171C5.68914 12.4578 5.98709 11.0327 5.53088 9.75657C5.24227 8.96489 5.10262 8.11727 5.11193 7.26034Z" fill="#0C8C5E"/>
|
||||
<path d="M17.2623 12.4395C16.3034 13.3802 15.1024 14.0322 13.7989 14.321C12.4862 14.6097 11.127 14.5259 9.86083 14.0788C9.86083 14.0788 9.85146 14.0788 9.84216 14.0788C8.56669 13.6224 7.14225 13.9205 6.18334 14.8706L3.12027 17.9256C2.98993 18.0561 3.00855 18.2703 3.16682 18.3727C4.48885 19.2576 6.07158 19.6861 7.67291 19.5743C9.38599 19.4532 10.9966 18.7174 12.2162 17.4972L12.2628 17.4506L17.2623 12.4488V12.4395Z" fill="#0C8C5E"/>
|
||||
<!-- Starter Kit label -->
|
||||
<text x="105" y="17" font-family="Inter, ui-sans-serif, system-ui, -apple-system, sans-serif" font-size="15" font-weight="500" fill="#A1A1AA" letter-spacing="-0.01em">Starter Kit</text>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 5.1 KiB |
@@ -0,0 +1,17 @@
|
||||
<svg width="180" height="23" viewBox="0 0 180 23" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<!-- mintlify wordmark paths -->
|
||||
<path d="M91.4402 21.4758H88.1331L90.4636 16.2156L85.8025 5.73975H89.1319L91.8475 12.3068C91.9428 12.5363 92.2682 12.5359 92.3624 12.3061L95.0575 5.73975H98.4091L91.4402 21.4758Z" fill="#09090B"/>
|
||||
<path d="M81.3934 16.8371V8.4031H79.1517V5.73971H81.3934V4.29706C81.3934 2.98017 81.7924 1.94441 82.5917 1.18979C83.391 0.435172 84.4044 0.0578613 85.6326 0.0578613C86.3869 0.0578613 87.0305 0.139242 87.5636 0.302003V2.98757C87.2084 2.8544 86.7941 2.78782 86.3202 2.78782C85.6549 2.78782 85.1739 2.93578 84.8778 3.23171C84.5817 3.51284 84.4337 3.99373 84.4337 4.67437V5.73971H87.5636V8.4031H84.4337V16.8371H81.3934Z" fill="#09090B"/>
|
||||
<path d="M76.4325 3.91974C75.9147 3.91974 75.4635 3.73479 75.0785 3.36488C74.6941 2.98017 74.5016 2.52148 74.5016 1.9888C74.5016 1.45613 74.6941 1.00484 75.0785 0.634923C75.4635 0.250216 75.9147 0.0578613 76.4325 0.0578613C76.9802 0.0578613 77.4384 0.250216 77.8087 0.634923C78.1932 1.00484 78.3857 1.45613 78.3857 1.9888C78.3857 2.52148 78.1932 2.98017 77.8087 3.36488C77.4384 3.73479 76.9802 3.91974 76.4325 3.91974ZM74.9235 16.8371V5.73971H77.9638V16.8371H74.9235Z" fill="#09090B"/>
|
||||
<path d="M69.6281 16.837V0.190918H72.669V16.837H69.6281Z" fill="#09090B"/>
|
||||
<path d="M66.1938 16.9702C64.951 16.9702 63.9299 16.6298 63.1306 15.9492C62.3466 15.2537 61.9545 14.255 61.9545 12.9529V8.40297H59.7129V5.73961H61.9545V2.65454H64.9949V5.73961H68.1247V8.40297H64.9949V12.3537C64.9949 13.0343 65.1429 13.5226 65.439 13.8185C65.735 14.0996 66.216 14.2402 66.8819 14.2402C67.3553 14.2402 67.7695 14.1736 68.1247 14.0405V16.726C67.5917 16.8888 66.948 16.9702 66.1938 16.9702Z" fill="#09090B"/>
|
||||
<path d="M48.3319 16.8369V5.73951H51.3726V6.55065C51.3726 6.68781 51.5593 6.74849 51.6501 6.64568C52.3279 5.87881 53.2934 5.49536 54.5464 5.49536C55.8781 5.49536 56.9213 5.93925 57.6759 6.82707C58.4453 7.70003 58.8299 8.86894 58.8299 10.3338V16.8369H55.7893V10.8443C55.7893 10.0305 55.6192 9.40164 55.2789 8.95776C54.9386 8.49908 54.4576 8.26971 53.8362 8.26971C53.0964 8.26971 52.4971 8.53606 52.0384 9.0687C51.5945 9.6014 51.3726 10.3856 51.3726 11.4213V16.8369H48.3319Z" fill="#09090B"/>
|
||||
<path d="M44.5472 3.91974C44.0293 3.91974 43.578 3.73479 43.1933 3.36488C42.8086 2.98017 42.6162 2.52148 42.6162 1.9888C42.6162 1.45613 42.8086 1.00484 43.1933 0.634923C43.578 0.250216 44.0293 0.0578613 44.5472 0.0578613C45.0946 0.0578613 45.5533 0.250216 45.9232 0.634923C46.308 1.00484 46.5003 1.45613 46.5003 1.9888C46.5003 2.52148 46.308 2.98017 45.9232 3.36488C45.5533 3.73479 45.0946 3.91974 44.5472 3.91974ZM43.0379 16.8371V5.73971H46.0786V16.8371H43.0379Z" fill="#09090B"/>
|
||||
<path d="M37.8749 16.8369V10.9109C37.8749 9.15009 37.2978 8.26971 36.1437 8.26971C35.4778 8.26971 34.9452 8.52126 34.5457 9.02435C34.1609 9.52739 33.9538 10.2747 33.9242 11.266V16.8369H30.8836V10.9109C30.8836 9.15009 30.3065 8.26971 29.1524 8.26971C28.4717 8.26971 27.9317 8.53606 27.5321 9.0687C27.1327 9.6014 26.9329 10.3856 26.9329 11.4213V16.8369H23.8922V5.73951H26.9329V6.55861C26.9329 6.69506 27.1163 6.75516 27.206 6.65229C27.8778 5.88103 28.7707 5.49536 29.8848 5.49536C31.3489 5.49536 32.4517 6.09981 33.193 7.30875C33.2515 7.40413 33.3954 7.4026 33.4536 7.30705C33.7741 6.78026 34.2195 6.36131 34.7898 6.05025C35.4409 5.68032 36.0993 5.49536 36.7652 5.49536C38.082 5.49536 39.103 5.93188 39.828 6.80484C40.5531 7.67785 40.9156 8.87637 40.9156 10.4004V16.8369H37.8749Z" fill="#09090B"/>
|
||||
<!-- M icon -->
|
||||
<path d="M19.4027 7.36208V1.35027C19.4027 0.705146 18.8794 0.190918 18.2439 0.190918H12.2349C11.291 0.190918 10.3565 0.377903 9.48742 0.733186C8.61827 1.09782 7.82396 1.62141 7.16042 2.29458L7.11373 2.34133C6.23527 3.22954 5.60912 4.33278 5.29138 5.54823C5.86143 5.39864 6.45019 5.32384 7.03895 5.3145C8.60891 5.29579 10.1509 5.80067 11.4032 6.745C12.534 7.58647 13.3937 8.74579 13.861 10.0828C14.3469 11.4385 14.403 12.9157 14.0386 14.3088C15.2441 13.991 16.3562 13.3645 17.244 12.4856L17.2907 12.4389C17.9543 11.7751 18.4869 10.9803 18.8514 10.1108C19.2159 9.24134 19.3934 8.30636 19.3934 7.36208H19.4027Z" fill="#18E299"/>
|
||||
<path d="M5.11193 7.26034C5.12124 5.4161 5.85673 3.64637 7.1508 2.32373L2.15129 7.32553C2.13267 7.34419 2.11404 7.3535 2.09543 7.3721C0.875804 8.58297 0.140324 10.2037 0.019293 11.9175C-0.0924279 13.5196 0.326517 15.103 1.22029 16.4257C1.30553 16.5519 1.53685 16.5933 1.6672 16.4723L4.73021 13.4171C5.68914 12.4578 5.98709 11.0327 5.53088 9.75657C5.24227 8.96489 5.10262 8.11727 5.11193 7.26034Z" fill="#0C8C5E"/>
|
||||
<path d="M17.2623 12.4395C16.3034 13.3802 15.1024 14.0322 13.7989 14.321C12.4862 14.6097 11.127 14.5259 9.86083 14.0788C9.86083 14.0788 9.85146 14.0788 9.84216 14.0788C8.56669 13.6224 7.14225 13.9205 6.18334 14.8706L3.12027 17.9256C2.98993 18.0561 3.00855 18.2703 3.16682 18.3727C4.48885 19.2576 6.07158 19.6861 7.67291 19.5743C9.38599 19.4532 10.9966 18.7174 12.2162 17.4972L12.2628 17.4506L17.2623 12.4488V12.4395Z" fill="#0C8C5E"/>
|
||||
<!-- Starter Kit label -->
|
||||
<text x="105" y="17" font-family="Inter, ui-sans-serif, system-ui, -apple-system, sans-serif" font-size="15" font-weight="500" fill="#71717A" letter-spacing="-0.01em">Starter Kit</text>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 5.1 KiB |
@@ -0,0 +1,81 @@
|
||||
---
|
||||
title: "Quickstart"
|
||||
description: "Start building awesome documentation in minutes"
|
||||
icon: 'rocket'
|
||||
---
|
||||
|
||||
## Get started in three steps
|
||||
|
||||
Get your documentation site running locally and make your first customization.
|
||||
|
||||
### Step 1: Set up your local environment
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion icon="copy" title="Clone your docs locally">
|
||||
During the onboarding process, you created a GitHub repository with your docs content if you didn't already have one. You can find a link to this repository in your [dashboard](https://dashboard.mintlify.com).
|
||||
|
||||
To clone the repository locally so that you can make and preview changes to your docs, follow the [Cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) guide in the GitHub docs.
|
||||
</Accordion>
|
||||
<Accordion icon="rectangle-terminal" title="Start the preview server">
|
||||
1. Install the Mintlify CLI: `npm i -g mint`
|
||||
2. Navigate to your docs directory and run: `mint dev`
|
||||
3. Open `http://localhost:3000` to see your docs live!
|
||||
|
||||
<Tip>Your preview updates automatically as you edit files.</Tip>
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
### Step 2: Deploy your changes
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion icon="github" title="Install our GitHub app">
|
||||
Install the Mintlify GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app).
|
||||
|
||||
Our GitHub app automatically deploys your changes to your docs site, so you don't need to manage deployments yourself.
|
||||
</Accordion>
|
||||
<Accordion icon="palette" title="Update your site name and colors">
|
||||
For a first change, let's update the name and colors of your docs site.
|
||||
|
||||
1. Open `docs.json` in your editor.
|
||||
2. Change the `"name"` field to your project name.
|
||||
3. Update the `"colors"` to match your brand.
|
||||
4. Save and see your changes instantly at `http://localhost:3000`.
|
||||
|
||||
<Tip>Try changing the primary color to see an immediate difference!</Tip>
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
### Step 3: Go live
|
||||
|
||||
<Accordion icon="rocket" title="Publish your docs">
|
||||
1. Commit and push your changes.
|
||||
2. Your docs will update and be live in moments!
|
||||
</Accordion>
|
||||
|
||||
## Next steps
|
||||
|
||||
Now that you have your docs running, explore these key features:
|
||||
|
||||
<CardGroup cols={2}>
|
||||
|
||||
<Card title="Write Content" icon="pen-to-square" href="/essentials/markdown">
|
||||
Learn MDX syntax and start writing your documentation.
|
||||
</Card>
|
||||
|
||||
<Card title="Customize style" icon="palette" href="/essentials/settings">
|
||||
Make your docs match your brand perfectly.
|
||||
</Card>
|
||||
|
||||
<Card title="Add code examples" icon="square-code" href="/essentials/code">
|
||||
Include syntax-highlighted code blocks.
|
||||
</Card>
|
||||
|
||||
<Card title="API documentation" icon="code" href="/api-reference/introduction">
|
||||
Auto-generate API docs from OpenAPI specs.
|
||||
</Card>
|
||||
|
||||
</CardGroup>
|
||||
|
||||
<Note>
|
||||
**Need help?** See our [full documentation](https://mintlify.com/docs) or join our [community](https://mintlify.com/community).
|
||||
</Note>
|
||||
@@ -0,0 +1,4 @@
|
||||
One of the core principles of software development is DRY (Don't Repeat
|
||||
Yourself). This is a principle that applies to documentation as
|
||||
well. If you find yourself repeating the same content in multiple places, you
|
||||
should consider creating a custom snippet to keep your content in sync.
|
||||
Reference in new issue
Block a user