​
CI checks

Add checks for broken links, linting, and grammar to the updating process
Plans: Pro and Enterprise plans include CI checks for GitHub repositories. See pricing.
Use CI checks to lint your docs for errors and provide warnings before you deploy. CI checks are configured to run on commits to your configured deployment branch, or on pull requests against that branch.

​
Installation

To begin, follow the steps on the GitHub setup guide. For GitHub Apps, you can choose to give permissions to only a single repository. We recommend doing so, as access is only needed for the repository where your docs are hosted.

​
Configuration

Configure the CI checks enabled for a deployment by navigating to the Add-ons page of your dashboard. Enable the checks that you want to run. When enabling checks, you can choose to run them at a Warning or Blocking level.
  • Warning: Will never provide a failure status, even if there are errors or suggestions.
  • Blocking: Will provide a failure status if not passed, or when changes are suggested.

​
Available CI checks

Similar to how the CLI link checker works on your local machine, CI automatically checks your docs for broken links. To see the results, visit GitHub’s check results page for the specific commit.

​
Vale

Vale is an open-source rule-based prose linter that supports a range of document types, including Markdown and MDX. Mintlify supports automatically running Vale in a CI check and displaying the results as a check status.

​
Configuration

If you have a .vale.ini file in the root content directory for your deployment, Mintlify will automatically use that configuration file. It also uses any configuration files in your specified stylesPath. If you do not have a Vale config file, the default configuration automatically loads. 
# Top level styles
StylesPath = /app/styles
MinAlertLevel = suggestion
IgnoredScopes = code, tt, img, url, a
SkippedScopes = script, style, pre, figure, code

# Vocabularies
Vocab = Mintlify

# This is required since Vale doesn't officially support MDX
[formats]
mdx = md

# MDX support
[*.mdx]
BasedOnStyles = Vale
Vale.Terms = NO # Enforces really harsh capitalization rules, keep off

# `import ...`, `export ...`
# `<Component ... />`
# `<Component>...</Component>`
# `{ ... }`
TokenIgnores = (?sm)((?:import|export) .+?$), \
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)

# Exclude:
# `<Component \n ... />`
BlockIgnores = (?sm)^(<\w+\n .*\s\/> )$, \
(?sm)^({.+.*})

CommentDelimiters = {/*, */}

# Default Vale vocabulary
Mintlify
mintlify
VSCode
openapi
OpenAPI
Github
APIs

repo
npm
dev

Lorem
ipsum
impsum
amet

const
myName
myObject
bearerAuth
favicon
topbar
url
borderRadius
args
modeToggle
ModeToggle
isHidden
autoplay

_italic_
Strikethrough
Blockquotes
Blockquote
Singleline
Multiline

onboarding

async
await
boolean
enum
func
impl
init
instanceof
typeof
params
stdin
stdout
stderr
stdout
stdin
var
const
let
null
undefined
struct
bool

cors
csrf
env
xhr
xhr2
jwt
oauth
websocket
localhost
middleware
runtime
webhook
stdin
stdout

json
yaml
yml
md
txt
tsx
jsx
css
scss
html
png
jpg
svg

cdn
cli
css
dom
dto
env
git
gui
http
https
ide
jvm
mvc
orm
rpc
sdk
sql
ssh
ssl
tcp
tls
uri
url
ux
ui

nodejs
npm
yarn
pnpm
eslint
pytest
golang
rustc
kubectl
mongo
postgres
redis

JavaScript
TypeScript
Python
Ruby
Rust
Go
Golang
Java
Kotlin
Swift
Node.js
NodeJS
Deno

React
Vue
Angular
Next.js
Nuxt
Express
Django
Flask
Spring
Laravel
Redux
Vuex
TensorFlow
PostgreSQL
MongoDB
Redis
PNPM

Docker
Kubernetes
AWS
Azure
GCP
Terraform
Jenkins
CircleCI
GitLab
Heroku

Git
git
GitHub
GitLab
Bitbucket
VSCode
Visual Studio Code
IntelliJ
WebStorm
ESLint
eslint
Prettier
prettier
Webpack
webpack
Vite
vite
Babel
babel
Jest
jest
Mocha
Cypress
Postman

HTTP
HTTPS
OAuth
JWT
GraphQL
REST
WebSocket
TCP/IP

NPM
Yarn
PNPM
Pip
PIP
Cargo
RubyGems

Swagger
OpenAPI
Markdown
MDX
Storybook
TypeDoc
JSDoc

MySQL
PostgreSQL
MongoDB
Redis
Elasticsearch
DynamoDB

Linux
Unix
macOS
iOS

Firefox
Chromium
WebKit

config
ctx
desc
dir
elem
err
len
msg
num
obj
prev
proc
ptr
req
res
str
tmp
val
vars

todo
href
lang
nav
prev
next
toc
Warning: For security reasons, Mintlify does not support absolute stylesPath values or any stylesPath that includes ... Use a relative stylesPath within your repository.

​
Packages

Vale supports a range of packages, which can be used to check for spelling and style errors. Any packages you include in your repository under the correct stylesPath are automatically installed and used in your Vale configuration. For packages not included in your repository, you may specify any packages from the Vale package registry, and they are automatically downloaded and used in your Vale configuration.
Warning: For security reasons, CI cannot automatically download packages that are not from the Vale package registry.

​
Vale with MDX

Vale does not natively support MDX, but Vale’s author provides a custom extension to support it. If you prefer not to use this extension, add the following lines to your .vale.ini file: 
[formats]
mdx = md

[*.mdx]
CommentDelimiters = {/*, */}

TokenIgnores = (?sm)((?:import|export) .+?$), \
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)

BlockIgnores = (?sm)^(<\w+\n .*\s\/> )$, \
(?sm)^({.+.*})
To use Vale’s in-document comments, use MDX-style comments {/* ... */}. If you use the CommentDelimiters = {/*, */} setting in your configuration, Vale automatically interprets these comments while linting. This means you can easily use Vale’s built-in features, like skipping lines or sections. 
{/* vale off */}

This text will be ignored by Vale

{/* vale on */}
If you choose not to use CommentDelimiters but still choose to use Vale’s comments, you must wrap any Vale comments in MDX comments {/* ... */}. For example: 
{/* <!-- vale off --> */}

This text will be ignored by Vale

{/* <!-- vale on --> */}
These comment tags are not supported within Mintlify components but can be used anywhere at the base level of a document.