chore(docs): migrate the docs site from Fumadocs to Blume (#753)

* Update documentation for ClassroomIO: change Fumadocs to Blume, revise MDX format conventions, and clarify sidebar navigation requirements.

* docs: update README and scripts for improved preview and error handling

* docs: update Discord link in configuration and documentation

* docs: add token-auth route and update documentation formatting

* Fix formatting in auto-comment-issues.yml

* Fix JSON syntax by adding a comma

* fix(docs): declare Blume's Astro build deps so Cloudflare build resolves them

blume build generates an Astro project under apps/docs/.blume/ that imports
astro, @astrojs/mdx, @tailwindcss/vite, tailwindcss, @tailwindcss/typography,
@shikijs/twoslash and @scalar/astro. Under pnpm's isolated node_modules these
are nested inside blume and not resolvable from the docs app, so a clean
--frozen-lockfile build (Cloudflare) fails at 'Cannot find module astro/config'.
Declare them directly in @cio/docs, pinned to blume's resolved versions.

* refactor(docs): update API reference paths and documentation for clarity

* fix: change platofrm url to docs home page

* Refactor documentation for self-hosting ClassroomIO

- Removed the Supabase Cloud setup guide as it is no longer needed.
- Updated the Enterprise SSO documentation to include a reference link for SSO & licensing.
- Added new documentation for Content Security Policy (CSP) configuration.
- Created a new section for configuring SMTP for email notifications.
- Introduced a comprehensive configuration index for self-hosted ClassroomIO, detailing environment variables and their usage.
- Added documentation for optional integrations including Google OAuth, OpenAI, and Unsplash.
- Documented the generation and usage of required secrets for ClassroomIO.
- Created a section for SSO & licensing, detailing the requirements for Enterprise features.
- Added object storage configuration documentation, covering both bundled MinIO and external S3-compatible services.
- Documented versioning and upgrade processes for ClassroomIO.
- Updated the Coolify and Docker self-hosting guides to streamline configuration references and upgrade instructions.
- Enhanced the Railway self-hosting guide with links to relevant configuration sections.
- Updated token authentication documentation to reference SSO & licensing.

* Add comprehensive guides for ClassroomIO features and functionalities

- Introduced a new guide for the Student Dashboard, detailing navigation and features available to students.
- Added a guide on using Tags for organizing and filtering courses within ClassroomIO.
- Created a guide on how to take attendance in courses, including marking attendance and related functionalities.
- Developed a Terminology guide to clarify key terms used throughout ClassroomIO.
- Implemented a Token Auth guide for signing users into ClassroomIO from external applications using JWT.
- Added instructions for using math in the editor with LaTeX support.
- Created a guide for customizing the welcome email sent to students upon enrollment in courses.
- Added a guide explaining what ClassroomIO is and its key features.
- Updated the home documentation to provide a clearer overview of ClassroomIO and its resources.
- Enhanced self-hosted configuration documentation with a new guide for deploying ClassroomIO on Dokploy.
- Updated links in the self-hosted configuration documentation for better navigation.
- Added new images to support the Dokploy deployment guide.
- Updated asset packaging script to handle redirects for the new guide structure.
- Fixed footer link to point to the correct Getting Started guide.

* chore: uprage version

* feat(docs): add DigitalOcean deployment guide and flatten guides structure

- Add a guide for deploying ClassroomIO on DigitalOcean using Docker Compose
  and Caddy for automatic HTTPS.
- List DigitalOcean as a deployment option in the self-hosting index.
- Move guides out of content/docs/guides into content/docs (student-dashboard,
  tags, terminology, token-auth, what-is-classroomio, audience, cohorts,
  community, course, enterprise-sso, mcp, organization, quickstart/*).
- Rename home.mdx to index.mdx.
- Update package-assets script to emit redirects for the old guides paths.

---------

Co-authored-by: Rotimi Best <best@classroomio.com>

apps/docs/package.json

@@ -2,44 +2,29 @@
   "name": "@cio/docs",
   "type": "module",
   "scripts": {
-    "dev": "react-router dev",
-    "build": "react-router build",
-    "preview": "wrangler dev --port 4173",
-    "start": "wrangler dev --port 3000",
+    "prebuild": "node scripts/fetch-openapi.mjs",
+    "dev": "node scripts/fetch-openapi.mjs && blume dev",
+    "build": "blume build && node scripts/package-assets.mjs",
+    "preview": "pnpm run build && wrangler dev --port 4173",
     "deploy": "pnpm run build && wrangler deploy",
-    "cf-typegen": "wrangler types && react-router typegen",
-    "types:check": "fumadocs-mdx && wrangler types && react-router typegen && tsc --noEmit",
-    "postinstall": "fumadocs-mdx"
+    "validate": "blume validate"
   },
   "dependencies": {
+    "@astrojs/mdx": "7.0.3",
     "@cio/utils": "workspace:*",
-    "@scalar/core": "^0.3.28",
-    "@react-router/dev": "^7.9.4",
-    "fumadocs-core": "16.2.1",
-    "fumadocs-mdx": "14.0.4",
-    "fumadocs-ui": "16.2.1",
-    "isbot": "^5.1.30",
-    "lucide-react": "^0.562.0",
-    "lucide-static": "^0.552.0",
-    "react": "^19.2.0",
-    "react-router": "^7.9.4",
-    "react-dom": "^19.2.0",
-    "tailwind-merge": "^3.3.1",
-    "vite": "^7.2.0"
+    "@scalar/astro": "0.4.9",
+    "@shikijs/twoslash": "4.3.1",
+    "@tailwindcss/typography": "0.5.19",
+    "@tailwindcss/vite": "4.1.18",
+    "astro": "7.0.9",
+    "blume": "1.1.2",
+    "mermaid": "^11.16.0",
+    "tailwindcss": "4.1.18"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "1.15.3",
-    "@tailwindcss/vite": "^4.1.16",
-    "@types/mdx": "^2.0.13",
-    "@types/node": "^24.10.0",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
-    "tailwindcss": "^4.1.16",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^5.1.4",
     "wrangler": "4.86.0"
   },
   "engines": {
-    "node": "^20.19.3"
+    "node": ">=22.12.0"
   }
 }