7287e31bb2
Adds content/docs/workspace-config.mdx covering: - Config tab overview (how to open, form vs raw YAML mode) - Claude Settings panel: gating condition, where to find it in the UI - Effort levels table: low / medium / high / xhigh (extended thinking) / max with descriptions, use-case guidance, cost/latency/quality tradeoffs - Task budget: token ceiling, 20k minimum, when it applies, sizing guidance - config.yaml reference with three annotated examples - Beta header note: task-budgets-2026-03-13 added automatically by executor - Executor wiring callout: config stored today, executor wiring ships next release Updates meta.json: adds workspace-config after concepts in the nav. Closes #608 (docs portion) Source PRs: molecule-monorepo#639 (effort + task_budget UI), #654 (max level) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| app | ||
| content/docs | ||
| lib | ||
| .gitignore | ||
| mdx-components.tsx | ||
| next.config.mjs | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.mjs | ||
| README.md | ||
| source.config.ts | ||
| tsconfig.json | ||
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
- Create a new
.mdxfile undercontent/docs/. - Add an entry to
content/docs/meta.jsonto control sidebar ordering. - Frontmatter:
titleanddescriptionare 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).