Inside of your Astro + Starlight project, you'll see the following folders and files:

.
├── public/
├── src/
│   ├── assets/
│   ├── content/
│   │   └── docs/
│   └── content.config.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json

Starlight looks for .md or .mdx files in the src/content/docs/ directory. Each file is exposed as a route based on its file name.

Images can be added to src/assets/ and embedded in Markdown with a relative link.

Static assets, like favicons, can be placed in the public/ directory.

All commands are run from the root of the project, from a terminal:

On desktop, select the presentation icon in the homepage header to present the landing page as an eleven-slide deck. The security trifecta and its six defence layers, and the cost dashboard and budget guardrails, have separate slides. The slideshow runtime, drawing tools, and snippet expansion JavaScript are loaded on demand on the first click, not when browsing the page. Slides fill the window edge to edge and retain their interactive examples. Use the previous/next buttons, arrow keys or Page Up/Page Down to navigate, Home/End to jump to the first/last slide, and Escape or the close button to return to the page. Keyboard controls inside demos keep their normal behavior. The presentation icon is hidden below the desktop menu breakpoint (50rem), and resizing to mobile exits the slideshow. Supported browsers slide the full frame left or right with CSS View Transitions; reduced-motion preferences disable these animations. The rounded, compact toolbar floats at the bottom center without reserving footer space. It rests at 65% opacity and becomes opaque on hover, keyboard focus, or while its drawing palette is open. Add data-slideshow-hide to any element to omit secondary content from the presentation without hiding it on the normal page. On a whole slide section, the attribute skips that slide and updates the navigation count. Guided-form notes, lengthy workflow descriptions, the extra workflow catalog, and the custom-engine footnote already use this annotation. When a demo tab is focused, Left/Right select tabs; Up/Down and Page Up/Page Down still navigate slides, and Tab/Shift+Tab leave the tablist.

The pencil button opens drawing tools inspired by Microsoft Streamer: colored rectangles (hold Shift for squares), arrows, and emoji stamps. Click to stamp an emoji or drag to resize and rotate it. Select the pointer tool to interact with demos. Undo (also Ctrl/Cmd+Z) and clear apply to the current slide. Drawings stay with their slide while presenting and are cleared when exiting. Escape leaves drawing mode and clears all annotations without leaving the slide; a second Escape exits the presentation. Drawing instructions appear in the question-mark tooltip on hover or keyboard focus.

Click a code snippet, prompt, or example output to expand it to a full-window view with larger type. Enter/Space also expand a focused snippet. The view zooms and fades smoothly (unless reduced motion is enabled); Escape or its close button returns focus to the snippet without changing slides. Code in the expanded view is editable as plain text for live demonstrations. Edits affect only the expanded copy and are discarded when it closes; opening the snippet again restores its original contents.

The robots file references /gh-aw/sitemap.xml, which is the stable sitemap entrypoint for the docs site.

During a production build (npm run build), Astro generates /gh-aw/sitemap-index.xml, and the static /gh-aw/sitemap.xml entrypoint points crawlers at that generated sitemap index. The generated sitemap index is not available when running the local development server (npm run dev).

If a CI pipeline or automated tool checks the generated sitemap index URL during a local preview, it will receive a 404 response. To verify the production sitemap flow, run npm run build followed by npm run preview.

This docs site is deployed as a GitHub Pages project site under /gh-aw/ (see base: '/gh-aw/' in astro.config.mjs).

• robots.txt is served at /gh-aw/robots.txt
• AI discovery file is served at /gh-aw/.well-known/ai.txt
• AI metadata files are served under /gh-aw/ai/

Root-level endpoints on https://github.github.com/ (for example /robots.txt) are controlled by the main github.github.com site, not this repository.

Check out Starlight’s docs, read the Astro documentation, or jump into the Astro Discord server.