Configuration

All top-level configurations for FlightManual live inside astro.config.mjs. If you are coming from Mintlify, this file acts as your equivalent to mint.json.

The `SITE_CONFIG` Object

At the top of your astro.config.mjs, you will find a SITE_CONFIG object. This is the central source of truth for your brand and platform settings.

const SITE_CONFIG = {
  // --- Required ---
  title: "FlightManual",
  tagline: "The Modern Content Substrate for the AI Era.",
  githubUrl: "https://github.com/scramjetio/flight-manual",

  // --- Optional ---
  logo: undefined,
  analyticsToken: undefined,
};

Branding Properties

Property	Type	Description
`title`	`string`	The name of your documentation site (appears in the header and `<title>` tags).
`tagline`	`string`	Used for SEO metadata and Open Graph descriptions.
`logo`	`string`	An optional path to an SVG or PNG logo to replace the default text header.

Socials & Analytics

Property	Type	Description
`githubUrl`	`string`	Automatically wires up the GitHub icon in the navigation bar and enables “Edit this page” links.
`analyticsToken`	`string`	Provide a Cloudflare Web Analytics token here, and FlightManual will automatically inject the tracking script.

The sidebar navigation is controlled within the starlight integration inside astro.config.mjs.

FlightManual supports Autogenerated Directories, which means you do not have to manually link every file. Just drop markdown files into a folder, and the sidebar will build itself.

sidebar: [
  { label: "Introduction", slug: "index" },
  { label: "Quickstart", slug: "quickstart" },
  {
    label: "Components",
    autogenerate: { directory: "components" },
  },
]

Styling (Tailwind v4)

FlightManual uses Tailwind CSS v4 coupled with a custom implementation of Shadcn UI.

Global Styles

To change your global brand colors, padding, and fonts, simply edit:

src/styles/custom.css (For Starlight core overrides)
src/styles/globals.css (For your Shadcn and Tailwind design tokens)