Skip to content

docs: Mintlify documentation site - #17

Merged
sidPhoenix17 merged 1 commit into
mainfrom
docs/mintlify-site
Aug 10, 2026
Merged

docs: Mintlify documentation site#17
sidPhoenix17 merged 1 commit into
mainfrom
docs/mintlify-site

Conversation

@sidPhoenix17

Copy link
Copy Markdown
Contributor

What

Turns docs/ into a self-contained Mintlify documentation site and migrates every existing Markdown doc into it.

Added

  • docs/docs.json — Mintlify config (theme, grouped nav, brand color, GitHub/Discord links)
  • Brand assets — docs/favicon.svg, docs/logo/{light,dark}.svg
  • docs/README.md — how to preview (mint dev) and deploy
  • MDX pages: landing, quickstart, concepts, use-cases; guides (creating a brain, populating entities, entity management, search configuration); agents (MCP context layer, connectors); deployment; full CLI reference

Migrated (content preserved)

  • docs/configuration.mddocs/guides/search-configuration.mdx
  • docs/deployment.mddocs/deployment.mdx
  • entity-management.mddocs/guides/entity-management.mdx
  • cookbooks.mddocs/use-cases.mdx

Repointed references

  • README (links), docker-compose.yml, open_index/ui/app.py, examples/cloud-brain/tools_server.py

Verification

  • docs.json is valid JSON; every internal link (href= and inline ](/...)) resolves to an existing page.
  • Ran locally with the Mintlify CLI (mint dev) under Node 22 — server responds HTTP 200, title "Open Index", all pages render.

Note: the Mintlify CLI requires an LTS Node (18/20/22); it hard-blocks Node 25+.

Deploy

Connect this repo in the Mintlify dashboard with root directory docs; pushes to the default branch publish automatically.

🤖 Generated with Claude Code

Convert docs/ into a self-contained Mintlify site and migrate the
existing Markdown docs into it.

- Add docs.json (theme, nav, brand color, GitHub/Discord links) plus
  favicon and logo assets.
- Author MDX pages: landing, quickstart, concepts, use-cases, guides
  (creating a brain, populating entities, entity management, search
  configuration), agents (MCP context layer, connectors), deployment,
  and a full CLI reference.
- Migrate docs/configuration.md -> docs/guides/search-configuration.mdx,
  docs/deployment.md -> docs/deployment.mdx, entity-management.md and
  cookbooks.md into the site.
- Repoint references in README, docker-compose.yml, ui/app.py, and the
  cloud-brain example to the new doc paths.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sidPhoenix17
sidPhoenix17 merged commit b274b5c into main Aug 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant