7cdc0bc9b4
Customer-facing documentation site for Molecule AI. Built with Fumadocs (open-source MIT, Next.js 15 App Router native, Tailwind v4, MDX) so we own the deployment and aesthetic and can grow into custom doc components for our agent-canvas flows. ## Why Fumadocs (over Mintlify, Nextra, Docusaurus) - Open source, no vendor lock-in (vs Mintlify SaaS subscription) - Built on Next.js 15 App Router — matches our existing canvas stack - Less opinionated than Nextra; can grow into custom doc components - React/Tailwind first; team already on this stack - Ships search, dark mode, Shiki highlighting, MDX out of the box ## Initial structure - app/ — Next.js App Router (home + docs + search route) - content/docs/ — MDX source (3 hand-written + 9 stub pages) - lib/source.ts — Fumadocs loader bound to the MDX content - mdx-components.tsx — default + future custom MDX renderers - source.config.ts — MDX compile config ## Hand-written launch content - index.mdx — landing / what you can build / how it works - quickstart.mdx — clone repo → docker compose → import template → talk to PM - concepts.mdx — the five primitives: workspaces / plugins / channels / schedules / canvas ## Stub pages (Documentation Specialist agent fills these in on cron) - org-template, plugins, channels, schedules - architecture, api-reference, self-hosting - observability, troubleshooting ## Ownership The Documentation Specialist agent in the molecule-dev org template will own this repo end-to-end: - Watches PRs landing in the platform monorepo - Auto-opens docs PRs when public APIs / templates / plugins / channels change - Runs daily cron to backfill stubs and refresh stale pages Manual edits welcome. Agent picks up on next cron tick.
32 lines
767 B
JSON
32 lines
767 B
JSON
{
|
|
"name": "molecule-docs",
|
|
"version": "0.1.0",
|
|
"private": true,
|
|
"description": "Molecule AI documentation site — doc.moleculesai.app",
|
|
"scripts": {
|
|
"build": "next build",
|
|
"dev": "next dev",
|
|
"start": "next start",
|
|
"postinstall": "fumadocs-mdx",
|
|
"lint": "next lint"
|
|
},
|
|
"dependencies": {
|
|
"fumadocs-core": "^15.0.0",
|
|
"fumadocs-mdx": "^11.0.0",
|
|
"fumadocs-ui": "^15.0.0",
|
|
"next": "^15.0.0",
|
|
"react": "^19.0.0",
|
|
"react-dom": "^19.0.0"
|
|
},
|
|
"devDependencies": {
|
|
"@types/mdx": "^2.0.13",
|
|
"@types/node": "^22.0.0",
|
|
"@types/react": "^19.0.0",
|
|
"@types/react-dom": "^19.0.0",
|
|
"tailwindcss": "^4.0.0",
|
|
"@tailwindcss/postcss": "^4.0.0",
|
|
"postcss": "^8.4.49",
|
|
"typescript": "^5.6.3"
|
|
}
|
|
}
|