classroomio/apps/docs/blume.config.ts

import { defineConfig } from 'blume';

/**
 * The site is served at classroomio.com/docs, proxied to this worker by the
 * marketing site (apps/website/src/hooks.server.ts). `deployment.base` only
 * rewrites URLs in the emitted HTML — it does not nest the build output, so
 * scripts/package-assets.mjs moves dist/ under docs/ to match the served path.
 *
 * Redirects are NOT declared here: under a base, Astro prefixes a redirect's
 * source but not its target, so it would emit `url=/guides` instead of
 * `/docs/guides`. They live in scripts/package-assets.mjs as a `_redirects` file.
 */
export default defineConfig({
  title: 'ClassroomIO Docs | Customer, Partner, and Employee Education',
  description:
    'Learn how to create customer academies, partner certification programs, and employee training workflows in ClassroomIO.',
  logo: {
    text: 'ClassroomIO',
    image: '/docs/logo-192.png',
    href: '/docs'
  },
  content: {
    root: 'content/docs'
  },
  deployment: {
    output: 'static',
    site: 'https://classroomio.com',
    base: '/docs'
  },
  github: {
    owner: 'classroomio',
    repo: 'classroomio',
    dir: 'apps/docs'
  },
  theme: {
    mode: 'system'
  },
  search: {
    provider: 'orama'
  },
  ai: {
    llmsTxt: true
  },
  seo: {
    x: {
      creator: '@classroomio',
      handle: '@classroomio'
    }
  },
  openapi: {
    enabled: true,
    renderer: 'scalar',
    route: '/api',
    sources: [{ label: 'API', spec: './openapi/public-api.json' }]
  },
  navigation: {
      tabs: [
      { label: 'Platform', path: '/', icon: 'house' },
      { label: 'Guides', path: '/guides', icon: 'book-open' },
      { label: 'Self Hosting', path: '/self-hosted', icon: 'server' },
      { label: 'API', path: '/api', icon: 'code' }
    ],
    sidebar: [
      {
        label: 'Platform',
        items: [
          '/',
          {
            label: 'Introduction',
            items: [
              '/what-is-classroomio',
              '/terminology',
              {
                label: 'Quickstart',
                items: ['/quickstart/signup', '/quickstart/onboarding']
              }
            ]
          },
          {
            label: 'Core Features',
            items: [
              '/course',
              '/cohorts',
              '/mcp',
              '/tags',
              '/audience',
              '/community',
              '/organization',
              '/student-dashboard',
              '/enterprise-sso',
              '/token-auth'
            ]
          }
        ]
      },
      {
        label: 'Guides',
        root: '/guides',
        items: [
          '/guides',
          {
            label: '',  // User Guides
            items: [
              {
                label: 'Get started',
                items: ['/guides/create-first-course']
              },
              {
                label: 'Build a course',
                items: [
                  '/guides/course-types',
                  '/guides/create-exercise',
                  '/guides/grade-exercise',
                  '/guides/course-progression',
                  '/guides/use-math-in-editor',
                  '/guides/certificates'
                ]
              },
              {
                label: 'Live classes',
                items: ['/guides/live-class', '/guides/take-attendance']
              },
              {
                label: 'Enrollment & students',
                items: [
                  '/guides/course-enrollment',
                  '/guides/welcome-email',
                  '/guides/invite-students'
                ]
              },
              {
                label: 'Publish your academy',
                items: [
                  '/guides/course-landingpage',
                  '/guides/org-landing-page',
                  '/guides/academy-sharing-and-branding',
                  '/guides/custom-domain'
                ]
              },
              {
                label: 'Organization & team',
                items: [
                  '/guides/admin-dashboard',
                  '/guides/customize-organization',
                  '/guides/invite-team-member',
                  '/guides/roles-and-permissions'
                ]
              }
            ]
          },
          {
            label: 'Developer Guides',
            items: [
              '/guides/contributing',
              '/guides/contributing/devs',
              '/guides/contributing/design',
              '/guides/contributing/cloudflare-setup',
              '/guides/contributing/org-site-opengraph-and-favicon',
              '/guides/contributing/gitpod',
              '/guides/contributing/demo-accounts',
              '/guides/contributing/student-dashboard',
              '/guides/contributing/adding-translation-to-code'
            ]
          }
        ]
      },
      {
        label: 'Self Hosting',
        root: '/self-hosted',
        items: [
          '/self-hosted',
          '/self-hosted/101',
          '/self-hosted/architecture',
          {
            label: 'Install',
            display: 'group',
            // Pinned open — it's what most visitors came for. The other groups
            // start collapsed (and auto-expand when they contain the current page).
            collapsed: false,
            items: [
              '/self-hosted/docker',
              '/self-hosted/digitalocean',
              '/self-hosted/railway',
              '/self-hosted/coolify',
              '/self-hosted/dokploy'
            ]
          },
          {
            label: 'Configure',
            display: 'group',
            collapsed: true,
            items: [
              '/self-hosted/configuration',
              '/self-hosted/configuration/secrets',
              '/self-hosted/configuration/email',
              '/self-hosted/configuration/storage',
              '/self-hosted/configuration/csp',
              '/self-hosted/configuration/integrations',
              '/self-hosted/enterprise'
            ]
          },
          {
            label: 'Manage',
            display: 'group',
            collapsed: true,
            items: ['/self-hosted/configuration/versions', '/self-hosted/backups']
          },
          {
            label: 'Troubleshoot',
            display: 'group',
            collapsed: true,
            items: ['/self-hosted/troubleshooting']
          }
        ]
      }
    ]
  }
});