astro.config.mjs

import { defineConfig } from "astro/config";
import rehypeSlug from "rehype-slug";
import { rehypeAutolink } from "./plugins/rehype-autolink";
import starlight from "@astrojs/starlight";
import tailwind from "@astrojs/tailwind";
import starlightLinksValidator from "starlight-links-validator";

const site = "https://handbook.shorebird.dev/";

// https://astro.build/config
export default defineConfig({
  site,
  integrations: [
    starlight({
      title: "Shorebird Handbook",
      tagline: "How we run our company and build our products",
      logo: {
        light: "./src/assets/shorebird-light.svg",
        dark: "./src/assets/shorebird-dark.svg",
        replacesTitle: true,
      },
      social: {
        github: "https://github.com/shorebirdtech/handbook",
        discord: "https://discord.gg/shorebird",
      },
      editLink: {
        baseUrl: "https://github.com/shorebirdtech/handbook/edit/main/",
      },
      favicon: "favicon.svg",
      head: [
        {
          tag: "meta",
          attrs: { property: "og:image", content: site + "open-graph.png?v=1" },
        },
        {
          tag: "meta",
          attrs: {
            property: "twitter:image",
            content: site + "open-graph.png?v=1",
          },
        },
      ],
      components: {
        MarkdownContent: "./src/components/starlight/MarkdownContent.astro",
      },
      customCss: ["./src/tailwind.css"],
      expressiveCode: {
        themes: ["dark-plus", "github-light"],
      },
      sidebar: [
        {
          label: "Overview",
          link: "/",
        },
        {
          label: "Company",
          link: "/company",
        },
        {
          label: "Benefits",
          link: "/benefits",
        },
        {
          label: "Onboarding",
          link: "/onboarding",
        },
        {
          label: "Engineering",
          link: "/engineering",
        },
        {
          label: "Community",
          link: "/community",
        },
        {
          label: "Security",
          link: "/security",
        },
        {
          label: "CEO",
          link: "/ceo",
        },
      ],
      plugins: [
        starlightLinksValidator({
          errorOnFallbackPages: false,
          errorOnInconsistentLocale: true,
        }),
      ],
    }),
    tailwind({ applyBaseStyles: false }),
  ],
  markdown: {
    rehypePlugins: [rehypeSlug, ...rehypeAutolink()],
  },
  redirects: {
    // Redirects to preserve legacy URLs.
  },
});