Go to file
molecule-ai[bot] b84a4af934
docs(self-hosting): add ADMIN_TOKEN production requirement page (#33)
* docs(concepts): add Memory Inspector panel (canvas PR #738)

Document the canvas Memory Inspector panel — Side Panel → Memory tab.
Covers browse (LOCAL/TEAM scopes), semantic search via ?q= param,
and key expansion. Notes polling cadence (~15s heartbeat cycle).

Pairs with molecule-core PR #738 and builds on the semantic search
docs from origin/docs/memory-semantic-search-784.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(self-hosting): add ADMIN_TOKEN production requirement page

Adds content/docs/self-hosting/admin-token.mdx explaining:
- ADMIN_TOKEN must be set in production (deadline April 22, 2026)
- Generation: openssl rand -base64 32
- What /admin/* endpoints it gates
- Fail-open risk when unset
- Verification and rotation steps

Also updates meta.json nav and adds cross-link from self-hosting.mdx.

Pairs with: monorepo PR #729 (issue #684)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Molecule AI Documentation Specialist <documentation-specialist@agents.moleculesai.app>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Molecule AI App-FE <app-fe@agents.moleculesai.app>
2026-04-20 22:41:19 +00:00
app feat: add External Agents, Token Management, MCP Server docs 2026-04-16 09:14:45 -07:00
content/docs docs(self-hosting): add ADMIN_TOKEN production requirement page (#33) 2026-04-20 22:41:19 +00:00
lib feat: add External Agents, Token Management, MCP Server docs 2026-04-16 09:14:45 -07:00
.gitignore chore: gitignore credentials for docs 2026-04-16 09:19:24 -07:00
mdx-components.tsx init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15 2026-04-14 21:01:17 -07:00
next.config.mjs init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15 2026-04-14 21:01:17 -07:00
package-lock.json feat: add External Agents, Token Management, MCP Server docs 2026-04-16 09:14:45 -07:00
package.json feat: add External Agents, Token Management, MCP Server docs 2026-04-16 09:14:45 -07:00
postcss.config.mjs init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15 2026-04-14 21:01:17 -07:00
README.md init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15 2026-04-14 21:01:17 -07:00
source.config.ts init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15 2026-04-14 21:01:17 -07:00
tsconfig.json feat: add External Agents, Token Management, MCP Server docs 2026-04-16 09:14:45 -07:00

Molecule AI Documentation

The customer-facing documentation site for Molecule AI, deployed at doc.moleculesai.app.

Built with Fumadocs + Next.js 15 (App Router) + Tailwind v4 + MDX.

Why Fumadocs

  • Open source (MIT) — we self-host on our own domain, no vendor lock-in
  • Next.js 15 native — matches the canvas stack already in the platform monorepo
  • Flexible — can grow into custom doc components for our agent canvas flows, embedded mini-canvases in docs, etc.
  • Modern aesthetic — Shiki code highlighting, full-text search, dark mode, all out of the box

Local development

npm install
npm run dev

Visit http://localhost:3000.

Adding pages

  1. Create a new .mdx file under content/docs/.
  2. Add an entry to content/docs/meta.json to control sidebar ordering.
  3. Frontmatter: title and description are required.
---
title: My new page
description: One-line summary used in nav + meta tags.
---

Content goes here.

Repository layout

.
├── app/                    # Next.js App Router routes
│   ├── (home)/             # marketing landing
│   ├── docs/[[...slug]]/   # docs dynamic route
│   ├── api/search/         # built-in full-text search
│   ├── layout.tsx          # root layout + RootProvider
│   └── layout.config.tsx   # nav links shared by home + docs
├── content/docs/           # MDX source — the actual documentation
│   ├── meta.json           # sidebar order
│   ├── index.mdx           # docs landing
│   └── *.mdx               # one file per page
├── lib/source.ts           # Fumadocs loader bound to the MDX source
├── mdx-components.tsx      # default + custom MDX renderers
├── source.config.ts        # MDX compile config (remark/rehype plugins)
├── next.config.mjs         # Next config wrapped with createMDX
├── postcss.config.mjs      # Tailwind v4 postcss plugin
└── package.json

Who maintains this

The Documentation Specialist agent in our molecule-dev org template owns this repo end-to-end. It runs on a schedule, watches PRs landing in the platform monorepo, and opens docs PRs here whenever:

  • A new public API endpoint lands
  • A new template / plugin / channel is added
  • A user-facing concept changes
  • An ecosystem-watch entry needs publishing

Manual edits welcome. The agent picks up changes on its next cron tick.

Deployment

This site is deployed to doc.moleculesai.app via Vercel (TBD — once the domain is configured). PRs to main ship to preview URLs automatically.

Contributing

Open a PR. The Documentation Specialist + a human reviewer will look at it within one cron tick (currently daily).