documentationbugfixrefactor

Changelog — March 25, 2026

Major documentation overhaul: fixed fumadocs v15 build compatibility, added complete architecture and API reference docs, and introduced a full user guide for studio, client, and retoucher roles.

🐛 Bug Fixes

  • Docs Build — fumadocs v15 Compatibility — Fixed a series of build errors in the apps/docs package caused by the fumadocs v15 + fumadocs-mdx@11 upgrade. Resolved TypeScript errors on generated types, corrected files() invocation to use the new function-call API, and fixed invalid shell operations in the Dockerfile (COPY syntax, mkdir public). Also removed duplicate H1 titles across all MDX pages that were causing rendering conflicts. #PR-327 #PR-328

♻️ Refactoring & Technical Improvements

  • Docs — Next.js Config & Tailwind/PostCSS Setup — Updated next.config.mjs and PostCSS config to align with fumadocs v15 requirements. Adjusted apps/docs/lib/source.ts to use the updated source stub pattern and regenerated .source/index.ts. Updated package.json dependencies and cleaned up pnpm-lock.yaml accordingly. #PR-327

📝 Other Changes

  • Architecture Documentation — Added comprehensive documentation pages covering system architecture (overview, workers, upload pipeline, email system), the REST API reference, SDK integration guide, pricing system, retouch flow, and environment variable configuration. #PR-327

  • User Guide — Added a full user guide section with dedicated pages for each role: Studio (project management & order creation), Client (reviewing & approving retouched images), and Retoucher (processing workflow & delivery). #PR-328

By Théo Daguier