chore(site): add index pages for breadcrumb steps

Author: JamieMason

site/src/components/DirectoryIndex.astro

@@ -0,0 +1,39 @@
+---
+import { getCollection } from 'astro:content';
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+
+interface Props {
+  directory: string;
+  title: string;
+  description: string;
+  intro: string;
+}
+
+const { directory, title, description, intro } = Astro.props;
+
+const allDocs = await getCollection('docs');
+const pages = allDocs
+  .filter((doc) => doc.id.startsWith(`${directory}/`) && doc.id !== `${directory}/index`)
+  .sort((a, b) => a.data.title.localeCompare(b.data.title));
+
+const pageData = {
+  title,
+  description,
+  template: 'doc',
+};
+---
+
+<StarlightPage frontmatter={pageData}>
+  <p set:html={intro} />
+
+  <CardGrid>
+    {pages.map((page) => (
+      <LinkCard
+        title={page.data.title}
+        href={`/syncpack/${page.id.replace(/\.mdx?$/, '')}/`}
+        description={page.data.description}
+      />
+    ))}
+  </CardGrid>
+</StarlightPage>

site/src/pages/command.astro

@@ -0,0 +1,10 @@
+---
+import DirectoryIndex from '@components/DirectoryIndex.astro';
+---
+
+<DirectoryIndex
+  directory="command"
+  title="Commands"
+  description="CLI commands for managing dependency versions across your monorepo"
+  intro="Syncpack provides several commands to lint, fix, format, and update dependencies in your monorepo."
+/>

site/src/pages/config.astro

@@ -0,0 +1,10 @@
+---
+import DirectoryIndex from '@components/DirectoryIndex.astro';
+---
+
+<DirectoryIndex
+  directory="config"
+  title="Configuration File"
+  description="Configure syncpack behavior through .syncpackrc files and command-line options"
+  intro="Configure syncpack's behavior using a <code>.syncpackrc</code> file in your project root. These options control formatting, sorting, dependency management, and version constraints."
+/>

site/src/pages/guide.astro

@@ -0,0 +1,10 @@
+---
+import DirectoryIndex from '@components/DirectoryIndex.astro';
+---
+
+<DirectoryIndex
+  directory="guide"
+  title="Guides"
+  description="Learn how to use Syncpack effectively in your monorepo"
+  intro="Step-by-step guides to help you get the most out of Syncpack in your JavaScript monorepo."
+/>

site/src/pages/reference.astro

@@ -0,0 +1,10 @@
+---
+import DirectoryIndex from '@components/DirectoryIndex.astro';
+---
+
+<DirectoryIndex
+  directory="reference"
+  title="Reference"
+  description="Technical reference documentation for Syncpack concepts and terminology"
+  intro="Reference documentation covering dependency types, specifier types, status codes, and glossary of terms used throughout Syncpack."
+/>

site/src/pages/semver-groups.astro

@@ -0,0 +1,10 @@
+---
+import DirectoryIndex from '@components/DirectoryIndex.astro';
+---
+
+<DirectoryIndex
+  directory="semver-groups"
+  title="Semver Groups"
+  description="Configure semver range formats for dependencies across your monorepo"
+  intro="Semver Groups define what semver range format dependencies should use (e.g., <code>^</code>, <code>~</code>, exact versions). These rules control how version ranges are formatted in your package.json files."
+/>

site/src/pages/version-groups.astro

@@ -0,0 +1,10 @@
+---
+import DirectoryIndex from '@components/DirectoryIndex.astro';
+---
+
+<DirectoryIndex
+  directory="version-groups"
+  title="Version Groups"
+  description="Control how dependency versions are managed across your monorepo"
+  intro="Version Groups define rules for how dependency versions should be managed across your monorepo. Each strategy provides different constraints and behaviors."
+/>