Skip to content

CodeStaple/mintify-starter

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

95 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ankra Mintlify Documentation

Welcome to the Ankra Mintlify documentation starter! This project provides a robust foundation for building and customizing your API and product documentation using Mintlify.

Features

  • Structured guide pages for onboarding and usage
  • Customizable navigation and theming
  • Auto-generated API Reference from OpenAPI specs
  • Rich component library for interactive docs
  • Easy local development and preview

Getting Started

  1. Clone this repository Use this template to kickstart your own documentation project.

  2. Install Mintlify CLI The Mintlify CLI lets you preview and develop your docs locally. Install globally with:

    npm i -g mintlify
  3. Preview Documentation Locally From the root directory (where docs.json is located), run:

    mintlify dev

    This will start a local server so you can view and edit your documentation in real time.

API Reference Integration

  • The API Reference tab is auto-generated from your OpenAPI specification.

  • To update the API docs, edit the openapi field in docs.json to point to your OpenAPI JSON or YAML file.

  • Example:

    {
      "tab": "API Reference",
      "openapi": "https://charizard.ankra.dev/openapi.json"
    }

Deployment

  • Connect your GitHub repository to Mintlify for automatic deployments.
  • Changes pushed to your default branch will be published to your live documentation site.

Troubleshooting

  • Mintlify CLI not running? Run mintlify install to re-install dependencies.
  • 404 errors? Ensure you are running the CLI in the directory containing docs.json.
  • OpenAPI not loading? Double-check your openapi URL and ensure it is a valid OpenAPI 3.0+ document.

Resources


For questions or support, reach out to the Ankra team or join the Mintlify community!

About

📖 The starter kit for your Mintlify docs

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • MDX 100.0%