Skip to main content

Introduction

DocStatic is a modern documentation platform that bridges the gap between writers and developers to help you create online documentation your users will love.

It simultaneously provides the best features of component content management systems and docs-as-code solutions for online documentation. With docStatic, anyone on your team can create and edit your documents without sacrificing your developer workflow.

Features​

DocStatic is a refinement of Tinasaurus, an open-source React-based project that combines a static site generator (Docusaurus) with a headless content management system (TinaCMS). It includes:

  • An easy-to-use editing interface for Markdown, MDX, JSON, and YAML content.
  • Integration with existing Git and CI/CD workflows.
  • Embedded MDX components for rich content authoring.
  • Media manager with support for third-party media providers.
  • Editing in the cloud (no local setup required).
  • Model Context Protocol (MCP) server for AI assistant integration.

Easy content management​

DocStatic's default collections include some of the more advanced authoring features you'd expect to find in a CCMS.

The rich text editor makes it easy to add:

  • Conditional text, snippets, and variable sets for content reuse
  • Taxonomies
  • Glossary terms
  • Code blocks, comments, collapsible details, figure, footnotes, and tabs. These are available as templates that you can insert into a content file.

The CMS uses a GraphQL schema to describe the shape of your content as a set of collections.

Git-backed​

Source control, automation and, optionally, publishing are managed through GitHub. When editing files with the rich-text editor, TinaCMS either commits on save or saves directly to the file if working locally. Git remains the source of truth for the whole team.

The repository structure is very similar to the Docusaurus defaults, but with some changes required for integration with TinaCMS.

Preconfigured plugins​

DocStatic is preconfigured with plugins supporting features such as KaTeX equations, Lunr search, Mermaid diagrams and OpenAPI docs. There is built-in support for internationalization (i18n). Multilingual spelling, grammar and, optionally, style checking are provided by LanguageTool through browser and IDE plugins.

AI Integration​

DocStatic includes an integrated Model Context Protocol (MCP) server that enables AI assistants to directly access and understand your documentation. This provides intelligent assistance for content editing, searching, and analysis based on your actual documentation structure and content.

React-based​

Content is stored in MDX format—an extension to Markdown that supports custom React components for features such as admonitions. These components are available universally and do not need to be declared in individual files. When working locally, the dev server instantly recompiles pages when you save your changes.

Fully documented​

Developers will find all the information they need to configure and start using docStatic in the Docusaurus and TinaCMS documentation. That information is not duplicated here, to avoid the possibility of it becoming out of date. Instead, the docStatic documentation focuses on using the CMS.

Related topics

  • Creating pages – Creating pages in the CMS.
  • CLI – DocStatic command line scripts.
  • Installation – How to install docStatic locally, and start a docStatic site in no time.
  • Configuration – Configuring your site's behavior through docusaurus.config.ts and more.
  • Internationalization – Translating documents with docStatic.
  • Styling and layout – A Docstatic site is a pre-rendered single-page React application. You can style it the way you style React apps.
  • Static assets – Static assets are the non-code files that are directly copied to the build output. Learn about how they are handled and the best practices for using static assets.