astro.config.mjs

// @ts-check
import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";
import react from "@astrojs/react";
import starlightClientMermaid from "@pasqal-io/starlight-client-mermaid";

// https://astro.build/config
export default defineConfig({
  site: "https://yaptide.github.io",
  base: "/for_developers",
  integrations: [
    react(),
    starlight({
      title: "YAPTIDE Developers",
      tagline: "A web-based IDE for Monte Carlo particle transport simulations",
      logo: {
        light: "./src/assets/yaptide-logo.svg",
        dark: "./src/assets/yaptide-logo.svg",
        replacesTitle: false,
      },
      favicon: "/favicon.svg",
      social: [
        { icon: "github", label: "GitHub", href: "https://github.com/yaptide" },
      ],
      customCss: ["./src/styles/custom.css"],
      editLink: {
        baseUrl: "https://github.com/yaptide/for_developers/edit/main/",
      },
      plugins: [starlightClientMermaid()],
      sidebar: [
        {
          label: "Home",
          slug: "",
        },
        {
          label: "Local Setup",
          items: [
            {
              label: "Frontend Demo",
              slug: "local-setup/local-frontend-demo",
            },
            {
              label: "Full Stack - Celery Workers",
              slug: "local-setup/local-celery",
            },
            {
              label: "Full Stack - SLURM",
              slug: "local-setup/local-slurm",
            },
          ],
        },
        {
          label: "Docker Setup",
          items: [
            {
              label: "Frontend Demo",
              slug: "docker-setup/docker-frontend-demo",
            },
            {
              label: "Full Stack - Celery Workers",
              slug: "docker-setup/docker-celery",
            },
            {
              label: "Full Stack - SLURM",
              slug: "docker-setup/docker-slurm",
            },
          ],
        },
        {
          label: "Architecture",
          items: [
            { label: "System Overview", slug: "architecture/overview" },
            { label: "Data Flow", slug: "architecture/data-flow" },
            {
              label: "Project JSON Schema",
              slug: "architecture/project-json-schema",
            },
            { label: "Authentication Model", slug: "architecture/auth-model" },
          ],
        },
        {
          label: "Orchestration Rework",
          collapsed: false,
          items: [
            { label: "Vision", slug: "rework-orchestration" },
            {
              label: "Context & Constraints",
              autogenerate: { directory: "rework-orchestration/context" },
            },
            {
              label: "Architecture Decisions",
              autogenerate: { directory: "rework-orchestration/adr" },
            },
            {
              label: "Design Documents",
              autogenerate: { directory: "rework-orchestration/design" },
            },
            {
              label: "Research Sessions",
              autogenerate: { directory: "rework-orchestration/research" },
            },
          ],
        },
        {
          label: "Contributing",
          collapsed: false,
          items: [
            { label: "Contribution Guide", slug: "contributing/guide" },
            { label: "Code Style", slug: "contributing/code-style" },
            { label: "Glossary", slug: "contributing/glossary" },
          ],
        },
        {
          label: "Backend",
          collapsed: true,
          items: [
            { label: "Overview", slug: "backend/overview" },
            { label: "API Reference", slug: "backend/api-reference" },
            { label: "Database", slug: "backend/database" },
            {
              label: "Simulation Lifecycle",
              slug: "backend/simulation-lifecycle",
            },
            {
              label: "Simulator Management",
              slug: "backend/simulator-management",
            },
            {
              label: "Docker Deployment",
              slug: "backend/docker-deployment",
            },
            { label: "Testing", slug: "backend/testing" },
          ],
        },
        {
          label: "Frontend",
          collapsed: true,
          items: [
            { label: "Overview", slug: "frontend/overview" },
            { label: "3D Editor", slug: "frontend/3d-editor" },
            {
              label: "Simulation Services",
              slug: "frontend/simulation-services",
            },
            {
              label: "Pyodide Converter",
              slug: "frontend/pyodide-converter",
            },
            { label: "Geant4 WebAssembly", slug: "frontend/geant4-wasm" },
            { label: "Auth Flows", slug: "frontend/auth-flows" },
            { label: "Adding Commands", slug: "frontend/adding-commands" },
            { label: "Testing", slug: "frontend/testing" },
          ],
        },
        {
          label: "Converter",
          collapsed: true,
          items: [
            { label: "Overview", slug: "converter/overview" },
            { label: "Conversion Flow", slug: "converter/conversion-flow" },
            {
              label: "Adding a Simulator",
              slug: "converter/adding-a-simulator",
            },
            { label: "SHIELD-HIT12A", slug: "converter/shieldhit" },
            { label: "FLUKA", slug: "converter/fluka" },
            { label: "Geant4", slug: "converter/geant4" },
            { label: "Testing", slug: "converter/testing" },
          ],
        },
        {
          label: "API Reference",
          collapsed: true,
          items: [
            { label: "Overview", slug: "api-reference/overview" },
            { label: "Authentication", slug: "api-reference/auth" },
            { label: "Jobs", slug: "api-reference/jobs" },
            { label: "Results", slug: "api-reference/results" },
            { label: "User", slug: "api-reference/user" },
          ],
        },
      ],
    }),
  ],
});