Project structure

Most of your work happens in two places: src/site.config.ts for settings, and src/content/ for pages and lists. You rarely need to open anything else.

carrgo-astro/
├── astro.config.mjs        your domain (site), the heading font
├── wrangler.jsonc          Cloudflare Workers deploy settings
├── scripts/
│   ├── palette.mjs         makes the colour scales and checks contrast
│   └── placeholders.mjs    draws stand-in images for any photo that's missing
└── src/
    ├── site.config.ts      company details, menus, booking, fares, driver pay, demo bar
    ├── content/
    │   ├── pages/          one file per page (index.md is the home page)
    │   ├── fleet/          your vehicles
    │   ├── services/       city rides, airport transfers, corporate…
    │   ├── cities/         the areas you cover
    │   └── posts/          blog posts
    ├── assets/images/      your photos
    ├── i18n/ui.ts          every word the theme prints (buttons, labels)
    ├── blocks/             the 22 blocks and their rules
    ├── components/         header, footer, booking form, fare estimator…
    ├── styles/             colours, sizes and one CSS file per block
    └── pages/              the page routes (you don't need to edit these)

Which page comes from which file

Address	File
/	src/content/pages/index.md
/fares/, /book/, /drive/…	src/content/pages/fares.md and so on
/fleet/executive/	src/content/fleet/executive.md
/services/airport-transfers/	src/content/services/airport-transfers.md
/cities/harbourside/	src/content/cities/harbourside.md
/blog/airport-pickup-guide/	src/content/posts/airport-pickup-guide.md

A new file in one of these folders becomes a new page when you save it. The vehicle, service, city and blog pages are laid out for you; you only write the details.

Pages you can delete

home-rideshare.md and home-chauffeur.md are the demo’s alternative home pages. Keep the one that suits your business and rename it to index.md, or delete both. Also delete /blocks/ and /style-guide/ if you don’t want them online: they’re the files src/pages/blocks.astro and src/pages/style-guide.astro. Neither page is in the sitemap.