agentic-engineering/astro.config.ts at main · software-mansion/agentic-engineering · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";
import starlightLlmsTxt from "starlight-llms-txt";
import { remarkClapButtons } from "./src/plugins/remark-clap-buttons";

const site = "https://agentic-engineering.swmansion.com/";
const repo = `https://github.com/software-mansion/agentic-engineering/`;
const defaultOgImage = `${site}og-default.png?v0`;

// https://astro.build/config
export default defineConfig({
  site,
  integrations: [
    starlight({
      title: "Software Mansion Agentic Engineering Guide",
      logo: {
        light: "./src/assets/logo-nav-light.svg",
        dark: "./src/assets/logo-nav-dark.svg",
        alt: "The Software Mansion Agentic Engineering Guide",
        replacesTitle: true,
      },
      description:
        "Practical guidance for setting up and scaling agentic engineering workflows in real software projects.",
      social: [
        {
          icon: "github",
          label: "GitHub",
          href: "https://github.com/software-mansion/agentic-engineering",
        },
        {
          icon: "x.com",
          label: "X",
          href: "https://x.com/swmansion",
        },
      ],
      sidebar: [
        { label: "Home", slug: "index" },
        {
          label: "Getting Started",
          items: [
            { slug: "getting-started/how-to-get-started" },
            { slug: "getting-started/glossary" },
            { slug: "getting-started/what-can-ai-agents-even-do" },
            { slug: "getting-started/how-to-set-up-a-new-repo" },
            { slug: "getting-started/first-steps-in-mature-projects" },
            { slug: "getting-started/towards-self-improvement" },
          ],
        },
        {
          label: "Becoming Productive",
          items: [
            { slug: "becoming-productive/the-workflow" },
            { slug: "becoming-productive/prompting-techniques" },
            { slug: "becoming-productive/harness-engineering" },
            { slug: "becoming-productive/closing-the-loop" },
            { slug: "becoming-productive/security" },
            { slug: "becoming-productive/legal-compliance" },
            { slug: "becoming-productive/going-10x" },
            { slug: "becoming-productive/what-not-to-do" },
          ],
        },
        {
          label: "Expanding Horizons",
          items: [
            { slug: "expanding-horizons/threads-context-and-caching" },
            { slug: "expanding-horizons/model-pricing" },
            { slug: "expanding-horizons/high-level-harnesses" },
            { slug: "expanding-horizons/autoresearch" },
            { slug: "expanding-horizons/model-evaluation" },
            { slug: "expanding-horizons/what-to-read-next" },
          ],
        },
      ],
      components: {
        Head: "./src/components/Head.astro",
        Footer: "./src/components/Footer.astro",
        SkipLink: "./src/components/SkipLink.astro",
        TableOfContents: "./src/components/TableOfContents.astro",
        Pagination: "./src/components/Pagination.astro",
      },
      editLink: {
        baseUrl: `${repo}edit/main/`,
      },
      lastUpdated: true,
      head: [
        {
          tag: "meta",
          attrs: { property: "og:image", content: defaultOgImage },
        },
        {
          tag: "meta",
          attrs: { property: "og:image:width", content: "1200" },
        },
        {
          tag: "meta",
          attrs: { property: "og:image:height", content: "630" },
        },
        {
          tag: "meta",
          attrs: { name: "twitter:image", content: defaultOgImage },
        },
        {
          tag: "meta",
          attrs: { name: "twitter:creator", content: "@swmansion" },
        },
      ],
      plugins: [starlightLlmsTxt()],
    }),
  ],
  markdown: {
    remarkPlugins: [remarkClapButtons],
  },
});