# Overview

> The marketing site in landing/: a static Astro site with no React or runtime, and the map of files you change to make it your own.

The marketing site in `landing/` is a static [Astro](https://astro.build) site with Tailwind v4. There
is no React and no runtime: everything renders to static HTML at build time. To make the template your
own you change copy and colours in a handful of known files, run the build, and ship the output. These
pages are the map of those files.

## Where things live

| You want to change…                        | Go to                                            | Page                                    |
| ------------------------------------------ | ------------------------------------------------ | --------------------------------------- |
| Brand copy, URLs, pricing, SEO defaults    | `src/config/site.ts`                             | [Brand and navigation](/docs/landing-site-brand) |
| Header navigation and footer links         | `src/config/navigation.ts`                       | [Brand and navigation](/docs/landing-site-brand) |
| Colours, design tokens, fonts, dark mode   | `src/styles/global.css`, `src/layouts/Layout.astro` | [Theming and dark mode](/docs/landing-site-theming) |
| The logo, favicon and Open Graph mark      | logo, favicon, `scripts/generate-og.mjs`         | [Theming and dark mode](/docs/landing-site-theming) |
| Blog posts and documentation pages         | `src/content/blog/`, `src/content/docs/`         | [Content and assets](/docs/landing-site-content) |
| Product screenshots and Open Graph images  | `scripts/capture-screenshots.mjs`, `generate-og.mjs` | [Content and assets](/docs/landing-site-content) |

## Develop and build

Run everything from the `landing/` directory:

| Goal             | Command        |
| ---------------- | -------------- |
| Dev server       | `pnpm dev`     |
| Production build | `pnpm build`   |
| Preview build    | `pnpm preview` |

`pnpm build` regenerates the Open Graph images (via the `build:og` step) and then renders the whole
site to static HTML in `dist/`. Deploy that directory to any static host.

One rule keeps dark mode working as you customise: prefer the semantic Tailwind utilities
(`bg-surface`, `text-muted`, `text-accent`) over hard-coded colours, so a change to the palette flows
to both themes. The pages that follow explain each area in turn.