Documentation operations

The docs repository is the source of truth for Moveat documentation. Mintlify renders and hosts the site, but the repository owns the content.

Current setup

Setting	Value
Hosting	Mintlify.
Domain	`docs.mov-eat.app`.
Source repo	`moveatApp/docs`.
Branch	`main`.
Config file	`docs.json` at repo root.
Languages	English and Spanish.

Branding

The header logo is configured in docs.json through the logo field. Mintlify supports separate light and dark logo files, but Moveat currently uses the same logo.png for both modes. If the logo does not render correctly in one color mode, add separate assets:

/logo-light.png
/logo-dark.png

Then configure:

"logo": {
  "light": "/logo-light.png",
  "dark": "/logo-dark.png",
  "href": "/"
}

Bilingual documentation

Moveat documentation is available in English and Spanish. The English version lives at the repository root and the Spanish version lives under es/ with the same structure. When content changes:

Update the English source page.
Update the matching Spanish page.
Validate docs.json navigation.
Push and verify the Mintlify deployment.

This keeps both language versions aligned while preserving one repository as the source of truth.

Content ownership

Content type	Owner
Product logic	Product/Founder plus engineering review.
Platform technical docs	Backend engineering.
Agent technical docs	Agent engineering.
Deployment and infra	Operations/backend engineering.
Testing status	Engineering, updated after meaningful coverage changes.
API specs	Generated from Platform Swagger/OpenAPI when possible.

Update workflow

Update MDX files in the docs repository.
Validate navigation references in docs.json.
Commit and push to main or open a PR.
Wait for Mintlify deploy.
Verify the live page at docs.mov-eat.app.

​Documentation operations

​Current setup

​Branding

​Bilingual documentation

​Content ownership

​Update workflow